|
1 | 1 | # Deploying
|
2 | 2 |
|
3 |
| -Deploying your documentation site can involve a lot of moving parts, but Ember CLI Addon Docs aims to streamline as much of the process as possible by providing a set of out-of-the-box conventions for deploying to GitHub Pages. |
| 3 | +Deploying your documentation site can involve a lot of moving parts, but Ember CLI AddonDocs aims to streamline as much of the process as possible by providing a set of out-of-the-box conventions for deploying to GitHub Pages. |
4 | 4 |
|
5 | 5 | Once everything is set up, you'll be able to visit <u>https://**[user]**.github.io/**[repo]**</u> to see the docs for the latest release of your addon, and your CI builds will automatically keep it up to date.
|
6 | 6 |
|
7 | 7 | ## Deploying your docs site
|
8 | 8 |
|
9 | 9 | To deploy your docs site to GitHub pages, you'll need to go through a few steps of first-time setup:
|
10 | 10 |
|
11 |
| -1. Run `ember g ember-cli-addon-docs` to set up the relevant deploy plugins (this is done automatically if you used `ember install` to install Addon Docs) |
| 11 | +1. Run `ember g ember-cli-addon-docs` to set up the relevant deploy plugins (this is done automatically if you used `ember install` to install AddonDocs) |
12 | 12 | 2. Set [the `repository` field](https://docs.npmjs.com/files/package.json#repository) of your `package.json`.
|
13 | 13 | 3. Commit any outstanding changes you've got on your current branch and push them to GitHub.
|
14 | 14 | 4. Run `ember deploy production` and answer "yes" if prompted to create a `gh-pages` branch. **Note**: if your repo already has a `gh-pages` branch, you may want to manually archive the existing content there before deploying.
|
@@ -38,7 +38,7 @@ If you were to make a change to your dummy app and run `ember deploy production`
|
38 | 38 |
|
39 | 39 | ## Versioning your content
|
40 | 40 |
|
41 |
| -Whenever you deploy your documentation site with Addon Docs, it places the compiled application in a subdirectory based on the current state of your git repository. All of this behavior [is customizable](#customizing-deploys), but we expect the out-of-the-box configuration should be a good place to get started. |
| 41 | +Whenever you deploy your documentation site with AddonDocs, it places the compiled application in a subdirectory based on the current state of your git repository. All of this behavior [is customizable](#customizing-deploys), but we expect the out-of-the-box configuration should be a good place to get started. |
42 | 42 |
|
43 | 43 | ### Tag deploys
|
44 | 44 |
|
@@ -107,7 +107,7 @@ stages:
|
107 | 107 |
|
108 | 108 | ## Customizing deploys
|
109 | 109 |
|
110 |
| -When you install Addon Docs, a `config/addon-docs.js` file will automatically be created for you that looks something like this: |
| 110 | +When you install AddonDocs, a `config/addon-docs.js` file will automatically be created for you that looks something like this: |
111 | 111 |
|
112 | 112 | ```js
|
113 | 113 | const AddonDocsConfig = require('ember-cli-addon-docs/lib/config');
|
@@ -145,7 +145,7 @@ If instead, however, you want to [set up a CNAME for your project](https://help.
|
145 | 145 |
|
146 | 146 | ### `getPrimaryBranch()`
|
147 | 147 |
|
148 |
| -This method determines what Addon Docs considers to be your primary branch, which is where links such as "edit this page" will point. By default, this branch is `master`, but you can override this method to choose a different branch instead, e.g. `develop`. |
| 148 | +This method determines what AddonDocs considers to be your primary branch, which is where links such as "edit this page" will point. By default, this branch is `master`, but you can override this method to choose a different branch instead, e.g. `develop`. |
149 | 149 |
|
150 | 150 | ## Removing a deployed version
|
151 | 151 |
|
|
0 commit comments