This project is deprecated in favor of cli-guides, which is an Ember app that hosts most of the content found here in the past. You can see the new site at cli.emberjs.com.
In the upcoming months, this site will remain up while the redirects and content migrations are being finished.
This is the recommended method for new contributors. Although the website is built with Ruby, most work is done in Markdown files. You don't need to know Ruby or install its dependencies to help out. Simply follow the Docker container instructions below to install and run locally.
First, install Docker and Compose and leave it running.
Next, the commands below will install all necessary dependencies for the website app and start a server. This will take a little while to run the first time, possibly a few minutes. The dependencies will be installed inside a Docker container, and do not affect your normal developer environment.
git clone https://github.com/ember-cli/ember-cli.github.io.git
cd ember-cli.github.io
docker-compose up
Install Jekyll and a special gem provided by GitHub:
$ gem install bundler
$ bundle
Open the directory which contains the repo and run Jekyll:
$ bundle exec jekyll serve -w
You can now view the result at http://localhost:4000.
If you want to help with the development of this site and you're using Windows, please read this guide about how to run Jekyll on your OS.
Alternatively, use bash via Windows Subsystem for Linux (WSL):
- Install/setup WSL
- Install ruby, perhaps use rbenv or linuxbrew.sh