karan-pathak / guides-app

Replacement for emberjs/guides and the Ember Guides

Home Page:https://guides.emberjs.com

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

Ember Guides App Build Status Build status

This repository contains the Ember App that powers the Ember.js Guides.

This app is essentially a static site generator that pulls in the markdown that makes up the Guides Source and outputs three things:

  • JSON that contains that content
  • an Ember App that is designed to consume that JSON
  • static html that is powered by Prember and FastBoot

If that all sounds a bit scary don't worry, thanks to Ember's Zero Config approach you don't need to worry about any of that to contribute 🎉

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!

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 #-team-learning channel in the Ember Community Slack.

If you were hoping to help with the contents of the Guides instead of the App that powers it then check out the contributing instructions for the Guides Source

Prerequisites for running this app

You will need the following things properly installed on your computer.

Installation

  • git clone https://github.com/ember-learn/guides-app.git
  • cd guides-app
  • npm install

Running / Development

Further Reading / Useful Links

Local Development alongside the Guides Source

If you are trying to make changes to the Guides App (this repo) and the Guides Source and want see your changes locally you need both repositories on your computer.

git clone git://github.com/ember-learn/guides-app.git
git clone git://github.com/ember-learn/guides-source.git

cd guides-source
npm link

cd ../guides-app/
npm i
npm link @ember-learn/guides-source
npm start

About

Replacement for emberjs/guides and the Ember Guides

https://guides.emberjs.com


Languages

Language:CSS 50.5%Language:JavaScript 42.5%Language:HTML 7.0%