Restructuring docs

docs/build-tool-config.md

@@ -0,0 +1,33 @@
+
+
+## Gruntfile.js (or .coffee)
+The last required file (in addition to `.aerobatic`, `package.json`, and `index.html`) is your `Gruntfile.js`. There's plenty of documentation on the Grunt site, so this will only cover the Aerobatic specific setup.
+
+```js
+module.exports = function(grunt) {
+  grunt.initConfig({
+    watch: {
+      options: {
+        spawn: true,
+        livereload: true
+      },
+      index: {
+        files: ['index.html']
+      },
+      css: {
+        files: ['css/*.css']
+      },
+      scripts: {
+        files: ['js/**/*.js'],
+        tasks: ['uglify']
+      }
+    }
+  });
+
+
+  grunt.registerTask('build', ['jshint', 'uglify', 'cssmin']);
+  grunt.loadNpmTasks('grunt-contrib-uglify');
+  grunt.loadNpmTasks('grunt-contrib-watch');
+  // Load other tasks
+};
+```  

docs/getting-started.md

@@ -0,0 +1,66 @@
+
+## Install yoke
+The `yoke` command line tool is used to power the development workflow including creating, building, and deploying application. Open your terminal and run the following:
+
+```
+npm install -g yoke-cli
+```
+
+## Logging in
+If this is the first time using yoke, you'll need to login by running the following:
+
+```
+yoke login
+```
+
+Your userId and secretKey can be found on the profile page: [https://portal.aerobaticapp.com/profile](https://portal.aerobaticapp.com/profile)
+
+## Creating an application
+To create a new application, simply type:
+
+```bash
+yoke app:create
+```
+
+The terminal interface will walk you through a short set of questions such as the name and optionally a starter template that will provide a solid scaffolding or various JS frameworks including [Angular](https://github.com/aerobatic/angular-seed), [Ember](https://github.com/aerobatic/emberjs-starter-kit), and [Backbone](https://github.com/aerobatic/backbone-boilerplate). If a starter template is selected, the installer will download the latest code from GitHub and run `npm install` and `bower install` (if a `bower.json` file is found).
+
+## Running app locally
+Now that the app code is downloaded, you can start a local development server with the following command:
+
+```
+yoke serve -o
+```
+
+The `-o` switch will automatically open a browser window to your app running at `http://localhost:3000` The port can be customized by including a `--port 4000` option.
+
+## Coding
+
+The development server is automatically configured for [livereload](http://livereload.com/), so as you change files like .js and .html, the browser will automatically reload upon save. For .css files, changes will automatically get pulled into the page without incurring a full page reload. You do not need to configure livereload in your `Gruntfile.js` or `gulpfile.js`, or rely on a browser plugin, `yoke` will take of it. At this point development can proceed in the familiar pattern.
+
+
+## Preview in release mode
+Before you deploy your app, you'll want to run it in release mode locally to ensure that there are no errors in the built assets. You can preview the app in `release` mode locally by running the following:
+
+```
+yoke serve -o --release
+```
+
+By default `yoke` will look for release assets in a directory at the root of your repo called either `build` or `dist`. However if you have a different directory convention, you can explicitly specify which files should be deployed in the `_aerobatic` section of the `package.json` file.
+
+## Deploying your app
+After validating that everything looks good in release mode, you're ready to deploy, which is as easy as:
+
+```
+yoke deploy
+```
+
+You'll be prompted for a version name (which is pre-populated with the version attribute from `package.json`) and an optional message. All text based assets are gzip compressed and deployed to the Aerobatic cloud platform. In just a few seconds your app is live to the world!
+
+## Next Steps
+Now that you've got a basic app running, here's some further topics to explore to gain a deeper understanding of how Aerobatic works and add more functionality to your app:
+
+* Working with index.html
+* Configuring Grunt or Gulp
+* Enabling OAuth
+* Communicating with APIs
+* Simulator mode