Ember Guides Source 
This repository contains the written content
for the Ember.js Guides.
Here, contributors can file issues and submit PRs to
help improve the learning experience of other developers.
Looking for repositories for the other parts of emberjs.com?
Check out
website,
ember-api-docs,
super-rentals tutorial,
statusboard,
deprecation-app,
and styleguide.
Contributing
Welcome and thanks for your help! Please see CONTRIBUTING.md
for detailed instructions on how to format your work and submit a Pull Request.
First-time contributors are encouraged to choose issues that are labeled
"help wanted" or "good for new contributors." If you have questions or
want a buddy to pair with, you can join the
dev-ember-learning channel
in the Ember Community Discord.
Project layout
The Guides content takes the form of Markdown files (just like most READMEs).
Each minor version of Ember has its own directory within /guides/.
Pull requests should make edits to only the contents of the guides/release directory,
which is the latest deployed version of the guides.
The exception is that PRs to fix broken links in older versions of the guides are ok.
On ember serve, the Markdown files are turned into HTML
to create an app. Most of the functionality comes from
guidemaker and
guidemaker-ember-template.
The styles come from ember-styleguide,
the shared home of components and stylesheets used throughout the family of
Ember sites.
Local Development
git clone git://github.com/ember-learn/guides-source.git
cd guides-source
npm install
ember serve
Visit http://localhost:4200
Running tests
Use npm to run tests instead of ember, since we have additional
tests like spellchecking that are not part of The Ember app's tests.
npm install
npm test
Linting and spellchecking
The guides are spellchecked and linted for Markdown consistency. You can test your contributions by running npm run lint:md. Linting and spellchecking must pass or they will fail in Travis-CI. See CONTRIBUTING.md for more information on linting and spellchecking.