docs muted

Author: ShMcK

_config.yml

@@ -15,10 +15,12 @@ using the coderoad-cli and tools developers already know: markdown and unit test
 
 # Build settings
 markdown: kramdown
+highlighter: rouge
 permalink: pretty
 
 gems:
   - jekyll-sitemap
+  - rouge
 
 # ----------------------- #
 #   3rd Party Settings    #

_includes/docs/docs.html

@@ -10,15 +10,15 @@
           <h1 id="overview" class="page-header">Overview</h1>
 
           <blockquote>
-            Docs are under development
+            Docs are under construction
           </blockquote>
 
-          {% for post in site.posts %}
+          {% for post in site.posts reversed %}
 
-          <section id="{{ post.id }}">
+          <!-- <section id="{{ post.id }}">
             <h2 class="section-heading">{{ post.title }}</h2>
-            <div>{{ post.content }}</div>
-          </section>
+            <div class="lead">{{ post.content }}</div>
+          </section> -->
 
           {% endfor %}
         </section>

_includes/docs/side-nav.html

@@ -6,7 +6,7 @@
             Overview
           </a>
         </li>
-        {% for post in site.posts %}
+        {% for post in site.posts reversed %}
         <li>
           <a class="page-scroll" href="#{{ post.id }}">
           {{ post.title }}

_posts/2016-01-01-development.md

@@ -4,4 +4,28 @@ title: Development
 id: development
 ---
 
-coming soon
+##### Development
+
+* In your development directory, run `> coderoad create $NAME$`
+
+* Run `> npm link` to create a symbolic link to your project
+
+* Update changes to your tutorial by running `> coderoad build`
+
+##### Viewing/Testing your Tutorial
+
+* Open a new directory and run `> npm init`
+
+* Add your package name to the `dependencies` in `package.json`:
+
+```
+"dependencies": {
+    "coderoad-$NAME$": "^0.1.0"
+  }
+```
+
+* Run `> npm link coderoad-$NAME$` & `> npm install`. This will install a package link pointing at your development tutorial.
+
+* Open [atom-coderoad](https://github.com/coderoad/atom-coderoad) to view your tutorial. Your package should appear as a loaded package.
+
+* Reload Atom if necessary (cmd + shift + P, type "reload", enter)

_posts/2016-01-05-cli.md

@@ -4,4 +4,58 @@ title: Coderoad-CLI
 id: cli
 ---
 
-coming soon
+##### Commands
+- create [name]
+- build [tutorial.md]
+- publish [version]   _currently instructions only_
+- tutorials           _coming soon_
+- search [query]      _currently instructions only_
+- docs
+- help
+
+##### Create
+
+"create" gets you started building your tutorial.
+
+```
+> coderoad create $my-tutorial-name$
+```
+
+"create" generates:
+
+* a `package.json` configuration with the following settings:
+
+```
+{
+  "name": "coderoad-$TUTORIAL-NAME$",
+  "main": "coderoad.json",
+  "keywords": ["coderoad", "tutorial"],
+  "dependencies": {
+      "mocha-coderoad": "^0.3.1"
+  },
+  "coderoad": {
+      "testDir": "test",
+      "testSuffix": ".spec.js",
+      "testRunner": "mocha-coderoad"
+}
+```
+
+* an example `tutorial.md` file & tutorial directory
+* an example `test` directory with a few example tests
+
+Feel free to fill out the "author" or "authors" field, and add any additional
+project related keywords.
+
+##### Build
+
+"build" compiles your markdown tutorial into a data file called `coderoad.json`.
+
+"build" defaults to `tutorial/tutorial.md`. Optionally specify the path to your tutorial markdown file.
+
+```
+> coderoad build
+> coderoad build $path/to/tutorial.md$
+```
+
+"build" also generates a `README.md` with an outline of your chapters & pages
+as well as an explanation of how to setup your tutorial.

css/docs.min.css

@@ -208,8 +208,8 @@ code {
 }
 
 .social-instructions {
-  font-size: 0.7em;
-  opacity: 0.7;
+  font-size: 0.8em;
+  opacity: 0.8;
 }