diff --git a/README.md b/README.md
index ffcbbad..979cc81 100644
--- a/README.md
+++ b/README.md
@@ -1 +1,17 @@
-# zengardenwebsites
\ No newline at end of file
+# zengardenwebsites
+
+Demo: https://john-doe.neocities.org/
+
+A website in a single HTML file. It simply uses the #anchor suffix and the :target CSS selector to show and hide pages/content.
+
+To create a new page, add a <section> with a unique id:
+```
+<section id="contact">
+   Contact me!
+</section>
+```
+Then you could add a link to it inside <nav>:
+
+```
+<a href="#contact">Contact</a>
+```