Update Readme (#29)

* Update Readme

* describe guidemaker dependency

* update badge

Author: Jen Weber

README.md

@@ -1,16 +1,23 @@
-## Ember-Cli Guides Source
+## ember-cli guides
 
-[![Build Status](https://travis-ci.org/ember-learn/cli-guides-source.svg?branch=master)](https://travis-ci.org/ember-learn/cli-guides-source)
+[![Build Status](https://travis-ci.org/ember-learn/cli-guides.svg?branch=master)](https://travis-ci.org/ember-learn/cli-guides-source)
 
-This repository is part of a Work-In-Progress project to refresh and replace the CLI guides content of [https://ember-cli.com](https://ember-cli.com).
+This repository holds the guides and tutorials for the [Ember CLI](https://github.com/ember-cli/ember-cli), a powerful tool that helps you create, develop, and build an Ember app.
 
-## Contributing
+To contribute to the API documentation itself, which lists properties and methods used by addons and apps, instead visit [Ember CLI](https://github.com/ember-cli/ember-cli), where the API docs are managed as code comments within the codebase.
 
-Do you know a thing or two about the CLI or addons? Do you _wish_ you knew a thing or do?  We'd love to have your help with writing or reviewing to make sure that content is helpful to all knowledge levels. To learn more about the motivation for this, read this [RFC](https://github.com/jenweber/rfcs-1/blob/cli-guides/active/0000-cli-guides.md).
+This project replaces, updates, and adds to the content historically hosted at [https://ember-cli.com/](https://ember-cli.com/).
 
-Overall project status and tasks that need help are tracked in [this Quest issue](https://github.com/ember-learn/cli-guides-source/issues/3). Have a read through that and the [CONTRIBUTING.md](CONTRIBUTING.md) file in order to get started.
+Looking for repositories for the other parts of [emberjs.com](https://emberjs.com)? 
+Check out
+[guides-source](https://github.com/ember-learn/guides-source),
+[website](https://github.com/emberjs/website),
+[ember-api-docs](https://github.com/ember-learn/ember-api-docs),
+[super-rentals tutorial](https://github.com/ember-learn/super-rentals),
+[statusboard](https://github.com/ember-learn/statusboard),
+[deprecation-app](https://github.com/ember-learn/deprecation-app),
+and [styleguide](https://github.com/ember-learn/ember-styleguide).
 
-As this project is pre-1.0, no content should be taken as technically authoritative.
 
 ## Prerequisites
 
@@ -23,7 +30,7 @@ You will need the following things properly installed on your computer.
 
 ## Local Development
 
-The Ember-Cli Guides is a normal Ember application so if you want to run it locally you follow the standard steps:
+The Ember-Cli Guides is a normal Ember application, so if you want to run it locally you follow the standard steps:
 
 * Clone this repository
 * `cd cli-guides-source`
@@ -38,6 +45,17 @@ To run the tests you can run `npm test` in your terminal, this will run any
 Ember tests that have been setup but also some scripts that check the Markdown
 files such as the link-checker.
 
+## How this app works 
+
+The guides content is in the form of Markdown files in the [guides](https://github.com/ember-learn/cli-guides/tree/master/guides) directory. An Ember app processes and serves the Markdown files. If you look at the `app` directory, you'll see there's not much in it! That's because most of the work is done through a dependency on [guidemaker](https://sea-region.github.com/empress/guidemaker), a static site generator created in Ember.
+
+## Contributing
+
+Do you know a thing or two about the CLI or addons? Do you _wish_ you knew a thing or do?  We'd love to have your help with writing or reviewing to make sure that content is helpful to all knowledge levels. To learn more about the motivation for this, read this [RFC](https://github.com/jenweber/rfcs-1/blob/cli-guides/active/0000-cli-guides.md). If you're new to writing Markdown, follow [this cheat sheet](https://guides.github.com/pdfs/markdown-cheatsheet-online.pdf).
+
+Overall project status and tasks that need help are tracked in [this Quest issue](https://github.com/ember-learn/cli-guides-source/issues/3). Have a read through that and the [CONTRIBUTING.md](CONTRIBUTING.md) file in order to get started.
+
+
 ### Adding more things to the table of contents
 
 See `pages.yaml` in the cli-guides-source. Whatever has a url of index will be what is shown for the top level path, like `/tutorial/`. There must be an `index.md` under each topic.