diff --git a/README.md b/README.md
index 301b42f..3eb9cc6 100644
--- a/README.md
+++ b/README.md
@@ -1,2 +1,128 @@
-# bil
-Basic Instruction Language
+# BIL ➸ Basic Instruction Language
+
+## What is BIL?
+
+BIL is a superset of [HTML](https://w3c.github.io/html) that adds twelve new tags and uses doctype of ``.
+
+
+## Why use BIL?
+
+BIL attempts to bridge the gap between natural languages like english, and more structured forms of language like [computer programming languages](https://en.wikipedia.org/wiki/Programming_language), [legalese](https://en.wikipedia.org/wiki/Legal_English), and [forms](https://en.wikipedia.org/wiki/Form_%28document%29).
+
+The challenge is to reduce ambiguity in written instructions by introducing additional markup and information about the parts of speech used, and to adhere to a consistent contextual structure for illustrating the relationships between the words.
+
+The goal is to arrive at an instruction language that acts both as a superset of HTML as well as a simplified subset of the natural language you are marking up as BIL. The aim is to present information in a way that a reader of the same natural language who has never seen BIL can understand it with a minimal learning curve to replace confusing instructions, verbose language, and ambiguous phrasing.
+
+
+## BIL Reference
+
+### Words
+
+- child of: any word tag, ``, or ``
+- parent of: any word tag, or ``
+
+Words are the elementary building blocks of BIL. You may nest word tags inside of each other infinitely deep (this is called putting words 'in the context of' another word) and this context-based nesting is the core idea of BIL.
+
+#### Noun
+
+- attribute(s): `proper`
+
+A `` tag wraps any noun or proper noun. Nouns are analogous to _generic objects_ in programming language.
+
+The `proper` attribute can be added to signify a proper noun. This is analogous to a _named variable_ in a programming language.
+
+#### Verb
+
+A `` tag wraps any verb, action, or set of actions. Verbs are analogous to _functions_ in a programming language.
+
+#### Number
+
+A `` tag wraps any numeric value.
+
+#### Adjective
+
+An `` tag wraps any adjective. These are analogous to _properties_ or _attributes_ in a programming language.
+
+#### Pronoun
+
+A `` tag wraps any pronoun. These address specific instances of nouns based on context.
+
+#### Preposition
+
+A `` tag wraps any preposition. These usually refer to the directionality, location, orientation, or state in which a verb or noun exists.
+
+#### Adverb
+
+An `` tag wraps any adverb. When used to modify verbs adverbs are analogous to _function arguments_ in programming languages.
+
+#### Conjunction
+
+A `` tag wraps any conjunction. Conjunctions are analogous to a lot of logical keywords like `if` and `while`.
+
+#### Interjection
+
+An `` tag wraps any interjection.
+
+
+### Grouping Operators
+
+#### Block
+
+- child of: ``
+- parent of: any word tags, and ``
+
+A `` tag is a grouping operator containing one or more words and a `` tag
+
+#### Context
+
+- child of: ``
+- parent of: any word tags, and ``
+
+A `` tag is a grouping operator containing `` tags and and/or `` tags.
+
+#### Phrase
+
+A `` tag is a grouping operator containing multiple word tags.
+
+
+## How to write BIL
+
+Always begin a BIL document with a containing `` tag:
+
+```html
+
+```
+
+This containing block may contain one or more word tags, plus a `` tag. This block is a `` block and will contain more words that define something in the context of a `` called 'BIL example':
+
+```html
+
+ BIL example
+
+
+```
+
+This `` tag may contain one or more word tags, more `` tags, or if there are multiple separate groupings of word tags each of these gropuings can be wrapped in `` tags:
+
+```html
+
+ BIL example
+
+ demo item 1
+ demo item 2
+
+
+```
+
+Here we could say that the `` 'item 1' is in the context of the `` 'demo', to demonstrate. We could also say that doing something with 'item 1' and 'item 2' are in the context of a `` called 'BIL example'.
+
+## BIL Demos
+
+- [How to decide which browser versions to support](examples/bil-browser.html)
+- [How to make a Vegan Iced Mocha](examples/bil-mocha.html)
+- [How to Make a S'more](examples/bil-smore.html)
+- [How to Make a Static HTML Website](examples/bil-static.html)
+- [How to Extract Audio from Youtube Videos](examples/bil-youtube.html)
+
+
+> Made with ♥ by [@innovati](https://twitter.com/innovati)
\ No newline at end of file
diff --git a/examples/bil-browser.html b/examples/bil-browser.html
new file mode 100644
index 0000000..6897cc7
--- /dev/null
+++ b/examples/bil-browser.html
@@ -0,0 +1,54 @@
+
+
+
+
+How to decide which browser versions to support
+
+
How to decide which browser versions to support
+
in Basic Instruction Language
+
+
Prose
+
+
For each browser version, the revenue per user is the total revenue divided by the total users.
+
The potential profit is the revenue per user multiplied by the users of this browser version.
+
The labour cost is the hourly rate multiplied by the estimated hours to support this browser version.
+
If the potential profit is greater than the labour cost, support this browser version.
+
+
Syntax
+
+
Foreachbrowserversion, the revenue per user is the total revenuedividedby the total users.
+
The potential profit is the revenue per usermultipliedby the users of thisbrowserversion.
+
The labour cost is the hourly ratemultipliedby the estimatedhourstosupportthisbrowserversion.
+
If the potential profit is greaterthan the labour cost, supportthisbrowserversion.
+
+
BIL
+
+
+ for each browser version
+
+
+ revenue per user
+
+ divide total revenuebytotal users
+
+
+
+ potential profit
+
+ multiply revenue per userbythis browser version users
+
+
+
+ labour cost
+
+ multiply hourly ratebyestimate hourstosupport this browser version
+
+
+
+ if greater potential profitthanlabour cost
+
+ support this browser version
+
+
+
+
\ No newline at end of file
diff --git a/examples/bil-mocha.html b/examples/bil-mocha.html
new file mode 100644
index 0000000..1335637
--- /dev/null
+++ b/examples/bil-mocha.html
@@ -0,0 +1,49 @@
+
+
+
+
+How to make a Vegan Iced Mocha
+
+
How to make a Vegan Iced Mocha
+
in Basic Instruction Language
+
+
Prose
+
+
How to make a vegan iced mocha.
+
For materials you will need a cup, a spoon, 250 ml of chocolate almond milk, and 250 ml of iced coffee.
+
The instructions are to put the milk and coffee inside the cup and mix with the spoon for 15 seconds.
+
+
Syntax
+
+
How to make a veganicedmocha.
+
For materials you will need a cup, a spoon, 250 ml of chocolatealmondmilk, and 250 ml of icedcoffee.
+
The instructions are to put the milkandcoffeeinside the cup and mixwith the spoon for 15 seconds.
+
+
BIL
+
+
+ mocha veganiced
+
+
+ make
+
+
+ materials
+
+ cup
+ spoon
+ milk almondchocolate250 ml
+ coffee iced250 ml
+
+
+
+ instructions
+
+ put milkandcoffeeinsidecup
+ mix withspoon15 seconds
+
+
+
+
+
+
\ No newline at end of file
diff --git a/examples/bil-smore.html b/examples/bil-smore.html
new file mode 100644
index 0000000..1196caa
--- /dev/null
+++ b/examples/bil-smore.html
@@ -0,0 +1,77 @@
+
+
+
+
+How to Make a S'more
+
+
How to Make a S'more
+
in Basic Instruction Language
+
+
Prose
+
+
How to make a s'more.
+
For materials you'll need a fire, a skewer, and the following ingredients: a marshmallow, 2 graham crackers, and 2 chocolate wafers.
+
Instructions: To make the bottom layer put 2 chocolate wafers on a graham cracker. Then put the skewer inside the middle of the marshmallow. Next put the skewer near the fire. Rotate the skewer slowly until the marshmallow's color is equal to golden brown. Then remove the skewer from the fire and put the skewer on the bottom layer. Finally put the graham cracker on top of the marshmallow and remove the skewer from the marshmallow.
+
+
Syntax
+
+
How to make a s'more.
+
For materials you'll need a fire, a skewer, and the following ingredients: a marshmallow, 2graham crackers, and 2chocolate wafers.
+
Instructions: To make the bottom layerput2chocolate waferson a graham cracker. Then put the skewerinside the middle of the marshmallow. Next put the skewernear the fire. Rotate the skewerslowlyuntil the marshmallow'scolor is equaltogolden brown. Then remove the skewerfrom the fire and put the skeweron the bottom layer. Finally put the graham crackeron top of the marshmallow and remove the skewerfrom the marshmallow.
+
+
BIL
+
+
+ s'more
+
+
+ make
+
+
+ materials
+
+ fire
+ skewer
+
+ ingredients
+
+ marshmallow
+ graham cracker 2
+ chocolate wafer 2
+
+
+
+
+
+ instructions
+
+
+ bottom layer
+
+
+ make
+
+ put chocolate wafer 2ongraham cracker
+
+
+
+
+ bottom layer make
+ put skewerinsidemarshmallow middle
+ put skewernearfire
+
+ until equal marshmallow colortogolden brown
+
+ rotate skewerslowly
+
+
+ remove skewerfromfire
+ put skeweronbottom layer
+ put graham crackeronmarshmallow
+ remove skewerfrommarshmallow
+
+
+
+
+
+
\ No newline at end of file
diff --git a/examples/bil-static.html b/examples/bil-static.html
new file mode 100644
index 0000000..748988b
--- /dev/null
+++ b/examples/bil-static.html
@@ -0,0 +1,178 @@
+
+
+
+
+How to Make a Static HTML Website
+
+
+
+
+ register domain name
+ ftp software connect todomain name
+ ftp software create default site files
+ ftp software edit index.htmltoequal default HTML
+ ftp software edit style.csstoequal default CSS
+
+
+
+
+
+
\ No newline at end of file
diff --git a/examples/bil-youtube.html b/examples/bil-youtube.html
new file mode 100644
index 0000000..e9d9e4b
--- /dev/null
+++ b/examples/bil-youtube.html
@@ -0,0 +1,32 @@
+
+
+
+
+How to Extract Audio from Youtube Videos
+
+
How to Extract Audio from Youtube Videos
+
+
+ extract data audiofromvideo youtube
+
+
+ instructions
+
+ web browser navigate toyoutube.com video
+ web browser copy page url
+ VLC media player as network sourceopen page url
+ VLC media player view Media Information
+ VLC media player Media Information copy Location
+ web browser navigate toLocation
+ web browser save video youtube
+ ffmpeg convert video youtubewith command
+
+ command
+
+
ffmpeg -i video youtube.mp4 -vn -acodec copy data audio.m4a
+
+
+
+
+
+
\ No newline at end of file
diff --git a/index.html b/index.html
new file mode 100644
index 0000000..8b37f27
--- /dev/null
+++ b/index.html
@@ -0,0 +1,326 @@
+
+
+
+
+BIL ➸ Basic Instruction Language
+
+
+
+
+
Basic Instruction Language
+
What is BIL?
+
BIL is a superset of HTML that adds twelve new tags and uses doctype of <!DOCTYPE bil>.
The challenge is to reduce ambiguity in written instructions by introducing additional markup and information about the parts of speech used, and to adhere to a consistent contextual structure for illustrating the relationships between the words.
+
The goal is to arrive at an instruction language that acts both as a superset of HTML as well as a simplified subset of the natural language you are marking up as BIL. The aim is to present information in a way that a reader of the same natural language who has never seen BIL can understand it with a minimal learning curve to replace confusing instructions, verbose language, and ambiguous phrasing.
+
BIL Reference
+
Words
+
+
child of: any word tag, <block>, or <phrase>
+
parent of: any word tag, or <block>
+
+
Words are the elementary building blocks of BIL. You may nest word tags inside of each other infinitely deep (this is called putting words 'in the context of' another word) and this context-based nesting is the core idea of BIL.
+
Noun
+
+
attribute(s): proper
+
+
A <noun> tag wraps any noun or proper noun. Nouns are analogous to generic objects in programming language.
+
The proper attribute can be added to signify a proper noun. This is analogous to a named variable in a programming language.
+
Verb
+
A <verb> tag wraps any verb, action, or set of actions. Verbs are analogous to functions in a programming language.
+
Number
+
A <number> tag wraps any numeric value.
+
Adjective
+
An <adjective> tag wraps any adjective. These are analogous to properties or attributes in a programming language.
+
Pronoun
+
A <pronoun> tag wraps any pronoun. These address specific instances of nouns based on context.
+
Preposition
+
A <preposition> tag wraps any preposition. These usually refer to the directionality, location, orientation, or state in which a verb or noun exists.
+
Adverb
+
An <adverb> tag wraps any adverb. When used to modify verbs adverbs are analogous to function arguments in programming languages.
+
Conjunction
+
A <conjunction> tag wraps any conjunction. Conjunctions are analogous to a lot of logical keywords like if and while.
+
Interjection
+
An <interjection> tag wraps any interjection.
+
Grouping Operators
+
Block
+
+
child of: <context>
+
parent of: any word tags, and <context>
+
+
A <block> tag is a grouping operator containing one or more words and a <context> tag
+
Context
+
+
child of: <block>
+
parent of: any word tags, and <phrase>
+
+
A <context> tag is a grouping operator containing <phrase> tags and and/or <block> tags.
+
Phrase
+
A <phrase> tag is a grouping operator containing multiple word tags.
+
How to write BIL
+
Always begin a BIL document with a containing <block> tag:
+
<block></block>
+
This containing block may contain one or more word tags, plus a <context> tag. This block is a <noun> block and will contain more words that define something in the context of a <noun> called 'BIL example':
This <context> tag may contain one or more word tags, more <block> tags, or if there are multiple separate groupings of word tags each of these gropuings can be wrapped in <phrase> tags:
Here we could say that the <noun> 'item 1' is in the context of the <verb> 'demo', to demonstrate. We could also say that doing something with 'item 1' and 'item 2' are in the context of a <noun> called 'BIL example'.