DOCS: more usage examples, new API section, other minor updates (#49)
DOCS: more usage examples, new API section, other minor updates (#49)

* DOCS: more usage examples, new API section, other minor updates

* DOCS: process review feedback

* address review comments. Add some section links in API section to examples.

-semicolon consistency
-spaces after hashes
-string -> list in "This string of dependencies"
-sequence generator function docs updated to account for param1=++sequence
-Description of intance.options updated
-Some section links added in API section pointing back to examples
-option_name -> `option_name`

bkeepers/rosie,bkeepers/rosie,bkeepers/rosie