Merge pull request #5 from mindreeper2420/v0.6.0

fix(readme): Update installation instructions and scripts

Author: mindreeper2420

README.md

@@ -4,12 +4,22 @@
 
 This template is for creating a website to track designs created by a UXD team. Built on Jekyll using GitHub pages, this template will enable you to quickly get up and running with a basic set of sortable and filterable tables, patterns for adding designs links and sharing stories from any issue tracking system.
 
-View the [Changelog]()
+View the [Changelog](CHANGELOG.md)
 
-----
+View the [Wiki](https://github.com/rh-uxd/design-tracker-template/wiki)
 
-## Local Development
-Run the environment locally using the steps below:
+---
+
+## Installation
+
+| This installation requires that you have Ruby, Node, Gem, Jekyll and Gulp installed. You can find a list of dependecies with versions here: [Design Tracker Dependencies](https://github.com/rh-uxd/design-tracker-template/wiki/Dependencies)
+
+1. Fork this repository
+1. Rename as desired (we recommend with UX in the name)
+1. Clone to your local machine
+1. With Node, Gulp, Ruby, Gem and Jekyll already installed, run `npm run initialize`
+1. Start with `jekyll serve`
+1. Code away!
 
 ### First Time Build
 1. Verify that you have the following installed:
@@ -28,16 +38,19 @@ Run the environment locally using the steps below:
     - for viewing locally at http://localhost:4000
 
 ### Subsequent Builds
-1. Run the npm command `npm run site`
+1. `jekyll serve` to start your environment on port `:4000`.
 
 ### Troubleshooting
-If you are having issues with the site building, you can run two sets of clean commands:
+If you are having issues with the site building, you can run a set of cleaning commands to reset your environment.
 
+#### Environment Troubles
+- `npm run reinstall`
+    - This will clear out your **node_modules** folder, any vendor folders, reinstall all modules and copy vendor files back to their respective locations.
 - `gulp cleanVendors`
-    - This will remove the vendor files that were copied over during the `gulp` process
-- `npm run clean`
-    - This will remove your node_modules directory, run `npm install`, run `gulp cleanVendors` to remove any old vendor files, and run `gulp` to copy updated vendor files.
+    - This will remove just the vendor files that were copied over during the `gulp` process.
+    - Run `gulp` to copy a clean set of vendor files back to your directories.
 
+#### Gem Issues
 If you have issues with your gem bundles, you can run the following command:
-- `npm run bundle`
-    - This will update the gem bundles. If you do not have node installed, just run `bundle update`.
+- `bundle update`
+    - This will check for any updates to your gem bundles, cleaning old bundles.

package.json

@@ -1,6 +1,6 @@
 {
   "name": "rh-uxd",
-  "version": "0.5.0",
+  "version": "0.6.0",
   "description": "Red Hat User Experience Design",
   "main": "index.js",
   "directories": {
@@ -11,7 +11,7 @@
     "refresh": "gulp cleanVendors && gulp",
     "bundle": "bundle update",
     "reinstall": "rimraf node_modules && npm install && gulp cleanVendors && gulp",
-    "site": "gulp && npm run bundle && jekyll serve"
+    "initialize": "gem install bundler && npm install && gulp && jekyll build"
   },
   "repository": {
     "type": "git",