move docs into organized markdown

ShMcK · ShMcK · commit 3249498c447f · 2016-07-02T16:37:01.000-07:00
diff --git a/_config.yml b/_config.yml
@@ -50,17 +50,6 @@ social:
   #forumbee:
   #tripadvisor:
   #amazon:
-tutorials:
-  - Functional School:
-    title: Functional School
-    language: JS
-    url: https://github.com/coderoad/coderoad-functional-school
-    description: A trip through functional programming in Javascript using common built-in Javascript array methods such as map & reduce.
-  - ES2015:
-    title: ES2015
-    language: JS
-    url: https://github.com/shmck/coderoad-es2015
-    description: Practice refactoring with ES2015 features.
 
 
 # Build settings
diff --git a/_posts/atom-coderoad/2016-01-01-explanation.md b/_posts/atom-coderoad/2016-01-01-explanation.md
@@ -0,0 +1,10 @@
+---
+layout: docs
+title: What is Atom-CodeRoad?
+id: explanation
+file: 2016-01-01-explanation.md
+categories:
+- atom-coderoad
+---
+
+Coming soon...
diff --git a/_posts/atom-coderoad/2016-01-02-installation.md b/_posts/atom-coderoad/2016-01-02-installation.md
@@ -0,0 +1,55 @@
+---
+layout: docs
+title: Quick Start
+id: install
+file: 2016-01-02-installation.md
+categories:
+- atom-coderoad
+---
+
+To play a **tutorial**, you'll only need **Atom-CodeRoad**.
+
+### Requirements
+
+Atom CodeRoad has several key dependencies before starting:
+
+* **NodeJS** > 0.10.x. Check your version with `> node -v`.
+    - download a newer version [here](https://nodejs.org).
+* **NPM** 3.x+. Check your version with `> npm -v`.
+    - NPM comes installed with NodeJS
+    - update with `> npm install -g npm`
+* **Atom Editor**
+    - A popular code editor available at [Atom.io](https://atom.io/)
+
+### Install
+
+You can install Atom packages inside of Atom through the following menus: "Atom -> Preferences -> Install", and search for "atom-coderoad".
+
+You may also choose to install *Atom Shell Commands* under the "Atom" menu. Shell commands allow you to quickly install Atom packages from the command line, for example: `> apm install atom-coderoad`.
+
+### Start
+
+Toggle open *Atom-CodeRoad* using the *Packages* menu or press *ctrl-alt-0*.
+
+
+### Tutorial
+
+To install a tutorial, setup a *package.json* file and save the tutorial as a dependency.
+
+![Install a Tutorial](/images/docs/install-tutorial.png){: .gif}
+
+You can setup a project quickly by typing `npm init --y` into the command line in your project's folder. This agrees to all of the defaults for your newly created *package.json* file.
+
+Now you can install a tutorial. Run `npm install --save-dev $THE-PACKAGE-NAME$` to save the tutorial as a package development dependency. If you run *Atom-CodeRoad* you should see the tutorial appear on the tutorial list screen.
+
+> If you are stuck at a screen that says 'install a tutorial', try updating your version of NPM to 3.x+.
+
+### Recommended
+
+##### Enable Autosave
+
+It's recommended you also enable *autosave* in Atom.
+
+![Enable autosave in Atom](/images/docs/autosave.png){: .gif}
+
+Tutorials run unit tests on save, *autosave* can speed up the process.
diff --git a/_posts/builder-coderoad/2016-01-01-explanation.md b/_posts/builder-coderoad/2016-01-01-explanation.md
@@ -0,0 +1,10 @@
+---
+layout: docs
+title: What is Builder-CodeRoad?
+id: explanation
+file: 2016-01-01-explanation.md
+categories:
+- builder-coderoad
+---
+
+Coming soon...
diff --git a/_posts/builder-coderoad/2016-01-02-installation.md b/_posts/builder-coderoad/2016-01-02-installation.md
@@ -0,0 +1,31 @@
+---
+layout: docs
+title: Quick Start
+id: install
+file: 2016-01-02-installation.md
+categories:
+- builder-coderoad
+---
+
+To create a **tutorial**, you'll need **Builder-CodeRoad**.
+
+### Requirements
+
+Builder CodeRoad has several key dependencies before starting:
+
+* *NodeJS* > 0.10.x. Check your version with `> node -v`.
+    - download a newer version [here](https://nodejs.org).
+* *NPM* 3.x+. Check your version with `> npm -v`.
+    - update with `> npm install -g npm`
+* *Atom Editor*
+    - available at [Atom.io](https://atom.io/)
+
+### Install
+
+You can install Atom packages inside of Atom through the following menus: "Atom -> Preferences -> Install", and search for "builder-coderoad".
+
+You may also choose to install *Atom Shell Commands* under the "Atom" menu. Shell commands allow you to quickly install Atom packages from the command line, for example: `> apm install builder-coderoad`.
+
+### Start
+
+Toggle open *Builder-CodeRoad* using the *Packages* menu or press *ctrl-alt-9*.
diff --git a/_posts/builder-coderoad/2016-01-03-development.md b/_posts/builder-coderoad/2016-01-03-development.md
@@ -4,7 +4,7 @@ title: Development
 id: development
 file: 2016-01-02-development.md
 categories:
-- docs
+- builder-coderoad
 ---
 
 Get setup quickly with CodeRoad: either [clone a tutorial repo](https://git-scm.com/docs/git-clone) or use the *CodeRoad-CLI*.
diff --git a/_posts/docs/2016-01-01-installation.md b/_posts/docs/2016-01-01-installation.md
diff --git a/_posts/docs/2016-01-01-tutorial.md b/_posts/docs/2016-01-01-tutorial.md
@@ -2,7 +2,7 @@
 layout: docs
 title: Tutorial Markdown
 id: tutorial-md
-file: 2016-01-03-tutorial.md
+file: 2016-01-01-tutorial.md
 categories:
 - docs
 ---
diff --git a/_posts/docs/2016-01-02-coderoad-api.md b/_posts/docs/2016-01-02-coderoad-api.md
@@ -2,7 +2,7 @@
 layout: docs
 title: CodeRoad API
 id: coderoad-API
-file: 2016-01-04-coderoad-api.md
+file: 2016-01-02-coderoad-api.md
 categories:
 - docs
 ---
diff --git a/_posts/docs/2016-01-03-tests.md b/_posts/docs/2016-01-03-tests.md
@@ -2,7 +2,7 @@
 layout: docs
 title: Unit Testing
 id: tests
-file: 2016-01-05-tests.md
+file: 2016-01-03-tests.md
 categories:
 - docs
 ---
diff --git a/_posts/docs/2016-01-04-loaders.md b/_posts/docs/2016-01-04-loaders.md
@@ -2,7 +2,7 @@
 layout: docs
 title: Loaders
 id: test-loaders
-file: 2016-01-06-loaders.md
+file: 2016-01-04-loaders.md
 categories:
 - docs
 ---
diff --git a/_posts/docs/2016-01-05-test-snippets.md b/_posts/docs/2016-01-05-test-snippets.md
@@ -2,7 +2,7 @@
 layout: docs
 title: Test Snippets
 id: test-snippets
-file: 2016-01-07-test-snippets.md
+file: 2016-01-05-test-snippets.md
 categories:
 - docs
 ---
diff --git a/_posts/docs/2016-01-06-test-examples.md b/_posts/docs/2016-01-06-test-examples.md
@@ -2,7 +2,7 @@
 layout: docs
 title: Test Examples
 id: test-examples
-file: 2016-01-08-test-examples.md
+file: 2016-01-06-test-examples.md
 categories:
 - docs
 ---
diff --git a/_posts/docs/2016-01-07-config.md b/_posts/docs/2016-01-07-config.md
@@ -2,7 +2,7 @@
 layout: docs
 title: Config
 id: config
-file: 2016-01-09-config.md
+file: 2016-01-07-config.md
 categories:
 - docs
 ---
diff --git a/_posts/docs/2016-01-08-publish.md b/_posts/docs/2016-01-08-publish.md
@@ -2,7 +2,7 @@
 layout: docs
 title: Publishing
 id: publish
-file: 2016-01-10-publish.md
+file: 2016-01-08-publish.md
 categories:
 - docs
 ---
diff --git a/_posts/docs/2016-01-09-test-runner.md b/_posts/docs/2016-01-09-test-runner.md
@@ -2,7 +2,7 @@
 layout: docs
 title: Test Runners
 id: test-runners
-file: 2016-01-11-test-runner.md
+file: 2016-01-09-test-runner.md
 categories:
 - docs
 ---
diff --git a/_posts/docs/2016-01-10-roadmap.md b/_posts/docs/2016-01-10-roadmap.md
@@ -2,20 +2,19 @@
 layout: docs
 title: Roadmap
 id: roadmap
-file: 2016-01-12-roadmap.md
+file: 2016-01-10-roadmap.md
 categories:
 - docs
 ---
 CodeRoad will become more flexible & powerful with time.
 
 ### v1.0.0
-* Improved test coverage
 * More test runners for different programming languages
+* Solutions when stuck
 
 ### v2.0.0
 * User accounts
 * Tutorial ratings
-* `@use` API for page feature choices
+* Features API, to allow for video, quizzes, etc.
 * Optional page templates
-* Testing tool for viewing your development tutorial in real-time
 * Suggestions?
diff --git a/_posts/docs/2016-01-11-contributing.md b/_posts/docs/2016-01-11-contributing.md
diff --git a/_posts/tutorials/2016-01-01-functional-school.md b/_posts/tutorials/2016-01-01-functional-school.md
@@ -0,0 +1,11 @@
+---
+layout: tutorial
+title: Functional School
+file: 2016-01-01-functional-school.md
+language: JS
+url: https://github.com/coderoad/coderoad-functional-school
+categories:
+- tutorials
+---
+
+A trip through functional programming in Javascript using common built-in Javascript array methods such as map & reduce.
diff --git a/_posts/tutorials/2016-01-02-es2015.md b/_posts/tutorials/2016-01-02-es2015.md
@@ -0,0 +1,11 @@
+---
+layout: tutorial
+title: ES2015
+file: 2016-01-02-es2015.md
+language: JS
+url: https://github.com/shmck/coderoad-es2015
+categories:
+- tutorials
+---
+
+Practice refactoring with ES2015 features.
diff --git a/atom-coderoad.html b/atom-coderoad.html
@@ -4,9 +4,18 @@
 tagline: Play Interactive Tutorials
 ---
 
-<h3>Atom-CodeRoad</h3>
-<p>Coming soon...</p>
-
-<ul>
-  <li>Setup<li>
-  <li>
+{% for post in site.categories.atom-coderoad reversed %}
+<br />
+<br />
+<section id="{{ post.id }}">
+  <h2>{{ post.title }}</h2>
+  <div>{{ post.content }}</div>
+  <br>
+  <a class="button" href="https://github.com/coderoad/coderoad.github.io/edit/master/_posts/docs/{{post.file}}">
+    <i class="fa fa-pencil fa-fw"></i>
+    <span class="network-name">
+      Edit {{post.title}} Docs
+    </span>
+  </a>
+</section>
+{% endfor %}
diff --git a/builder-coderoad.html b/builder-coderoad.html
@@ -4,14 +4,27 @@
 tagline: Create Interactive Tutorials
 ---
 
-<h3>Builder-CodeRoad</h3>
-<p>Coming soon...</p>
-
+{% for post in site.categories.builder-coderoad reversed %}
+<br />
+<br />
+<section id="{{ post.id }}">
+	<h2>{{ post.title }}</h2>
+	<div>{{ post.content }}</div>
+	<br>
+	<a class="button" href="https://github.com/coderoad/coderoad.github.io/edit/master/_posts/docs/{{post.file}}">
+		<i class="fa fa-pencil fa-fw"></i>
+		<span class="network-name">
+			Edit {{post.title}} Docs
+		</span>
+	</a>
+</section>
+{% endfor %}
+<!--
 <ul>
 	<li>Installation</li>
 	<li>Setup</li>
 	<li>Visualize</li>
 	<li>Tests</li>
 	<li>Validation</li>
 	<li>Publish</li>
-</ul>
+</ul> -->
diff --git a/index.html b/index.html
diff --git a/tutorial-docs.html b/tutorial-docs.html
