diff --git a/README.md b/_includes/HTML6.md
similarity index 86%
rename from README.md
rename to _includes/HTML6.md
index db16ab9..0aa7400 100644
--- a/README.md
+++ b/_includes/HTML6.md
@@ -1,6 +1,6 @@
# HTML6
-
+
## The Spec That Brings Us Freedom
@@ -29,7 +29,7 @@ Now, without further adieu, let me introduce you to HTML6.
### Section 2 - The Concept
-HTML6 is conceptually HTML with XML like namespaces. If you don't know XML, or don't know what XML namespaces are they're basically a way to allow you to use the same tag without it conflicting with a different tag. You've probably actually seen one before in the XHTML DOCTYPE: `xmlns:xhtml="http://www.w3.org/1999/xhtml"`
+HTML6 is conceptually HTML with XML like namespaces. If you don't know XML, or don't know what XML namespaces are, they're basically a way to allow you to use the same tag without it conflicting with a different tag. You've probably actually seen one before in the XHTML DOCTYPE: `xmlns:xhtml="http://www.w3.org/1999/xhtml"`
In HTML6 we take advantage of this ingenious concept by giving us freedom to use whatever tag we want by the W3C reserving namespaces and not tags. The W3C would basically reserve the right to all namespaces, and each namespace they reserve will trigger a different HTML API.
@@ -104,7 +104,7 @@ _Example:_
```
##### ``
-This begins an HTML's head. Equivelent to the current `` tag. The tag contains data that isn't actually displayed (aside from the `` which is displayed in the browser's windows). Rather, it's purpose is to get data and scripts that affect the display of the content in the ``. These scripts and other sources include things like JavaScript, CSS, RSS feeds, etc.
+This begins an HTML's head. Equivelent to the current `` tag. The tag contains data that isn't actually displayed (aside from the `` which is displayed in the browser's windows). Rather, it's purpose is to get data and scripts that affect the display of the content in the ``. These scripts and other sources include things like JavaScript, CSS, RSS feeds, etc.
_Example:_
@@ -136,8 +136,13 @@ _Example:_
This is a bit different then the current HTML version. Meta data in HTML6 can be anything. Unlike HTML now, there are no required or non-standard meta types. It's used to store content for you as a developer, or for other sites as a way to grab information such as a page description.
-_Example:_
+_Normative:_
+This tag has to be a descendant of `html:head` and takes the following attributes:
+
+- `type`: What type of information is under `value`, eg. `author`, `description` or `generator`; there can be multiple types, separated by `,`.
+- `value`: The information itself.
+_Example:_
```xml
@@ -148,23 +153,50 @@ _Example:_
```
-##### ``
+##### ``
+
+This links document's alternatives in other formats, eg. PDF, RTF, RSS or Atom feed. It's similar to the current HTML `link` tag.
-This links external documents and scripts such as CSS, JavaScript, RSS, favicons, etc. to the current document. Equivalent to the current `` tag. This tag takes the following attributes:
+_Normative:_
+This tag has to be a descendant of `html:head` and takes the following attributes:
+- `title`: The name of the alternative document.
- `charset`: The character encoding such as "UTF-8".
-- `href`: The link to the source file.
-- `media`: The type of device the item should run on, for example, "mobile" or "tablet".
+- `href`: The link to the source file, can be relative or absolute.
+- `media`: The type of device the item should run on, eg. `mobile` or `tablet`.
- `type`: The MIME type of the document, for example, `text/javascript`.
-_Example:_
+_Example:_
+```xml
+
+
+
+ HTML6 Spec Version 0.1
+
+
+
+```
+
+##### ``
+
+This links external files that should be included in the document such as HTML snippets, CSS templates or JS scripts. It's similar to the current HTML `link` tag.
+_Normative:_
+This tag takes the following attributes:
+
+- `rel`: The type of the document, eg. `stylesheet`, `script`, `snippet`, `favicon`.
+- `charset`: The character encoding such as "UTF-8".
+- `src`: The link to the source file, can be relative or absolute.
+- `media`: The type of device the item should run on, for example, "mobile" or "tablet".
+- `type`: The MIME type of the document, eg. `text/javascript`.
+
+_Example:_
```xml
HTML6 Spec Version 0.1
-
+
```
@@ -189,13 +221,15 @@ _Example:_
##### ``
-This tag represents either an anchor on the page, or a link to another web page. Equivalent to the current `` tag. The `` tag takes one required attribute which is the `href` which directs the anchor or link where to go. For an anchor you'd use the syntax `#id-of-element-to-link-to` and for a link to another web page you'd simply insert the link like `http://google.com`.
+This tag represents a link to another web page or an anchor. It's similar to the current `` tag.
-Attributes available to the `` tag are:
+_Normative:_
+Attributes available to this tag are:
-- `href`
-- `name`
-- `target` (can be `blank`, `parent`, `top` or `self`)
+- `href`: The link to the target document (can be relative or absolute) or a hashtag and element id (like this: `#some-foo-element`).
+- `for`: CSS selector for when you need to make an anchor to an element with no id (always links to the first match).
+- `target`: Which window will open the document (can be `blank`, `parent`, `top` or `self`, default is `self`). **This attribute is obsolete**.
+- `newwindow`: Boolean attribute saying that link will be opened in a new window (equivalent to `target=blank`).
_Example:_
@@ -206,7 +240,10 @@ _Example:_
HTML6 Spec Version 0.1
- Go to google.com!
+
MyPage
+ Go to google.com!
+ Back to the top
+ Back to the top alternative
```