diff --git a/README.md b/README.md
new file mode 100644
index 0000000..bbdb03d
--- /dev/null
+++ b/README.md
@@ -0,0 +1,40 @@
+# y.css
+
+This is a very clean CSS to start with.
+
+You have some typography classes for small caps for example.
+
+Typically: 
+
+- the right size of the content.
+- header numbering inside article, 
+- nice link (no underline, but a sup cross)
+
+<pre><code>
+<html>
+    <head>
+        <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
+        <link rel="stylesheet" type="text/css" href="y.css" />
+        <title>Page title</title>
+    </head>
+    <body>
+        <header>
+            <h1>Title</h1>
+            <h2>Subtitle</h2>
+        </header>
+
+        <article>
+            <title> <h1>Article Title</h1> </title>
+            <p>This is the article</p>
+            <h2>section</h2>
+            <h3>subsection</h3>
+            <p>Some <em>content</em> <strong>with</strong> <a href="#">a link</a>. </p>
+            <blockquote>A blockquote</blockquote>
+        </article>
+
+        <footer>
+        <p>Footer content</p>
+        </footer>
+    </body>
+</html>
+</code></pre>
diff --git a/index.html b/index.html
index 5d0074a..2b0bc23 100644
--- a/index.html
+++ b/index.html
@@ -2,24 +2,25 @@
     <head>
         <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
         <link rel="stylesheet" type="text/css" href="y.css" />
-        <title>HTML Title</title>
+        <title>Page title</title>
     </head>
     <body>
-        <h1> This is the main page title </h1>
-        <h2> With a subtitle </h2>
+        <header>
+            <h1>Title</h1>
+            <h2>Subtitle</h2>
+        </header>
+
         <article>
-            <title>
-                <h1>The article title</h1>
-            </title>
+            <title> <h1>Article Title</h1> </title>
             <p>This is the article</p>
-            <h2> A sub title </h2>
-            <p>Something to say?  <a href="#">This is a link</a> </p>
-            <blockquote>
-                This is a blockquote
-            </blockquote>
+            <h2>section</h2>
+            <h3>subsection</h3>
+            <p>Some <em>content</em> <strong>with</strong> <a href="#">a link</a>. </p>
+            <blockquote>A blockquote</blockquote>
         </article>
+
         <footer>
-        This is the footer
+        <p>Footer content</p>
         </footer>
     </body>
 </html>
