Skip to content

Commit 15f0559

Browse files
authored
Touch up quickstart (ember-learn#358)
1 parent 8bceb98 commit 15f0559

File tree

12 files changed

+134
-125
lines changed

12 files changed

+134
-125
lines changed

README.md

+1-1
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,4 @@
1-
# Ember CLI Addon Docs
1+
# Ember CLI AddonDocs
22

33
[![npm version](https://img.shields.io/npm/v/ember-cli-addon-docs.svg?style=flat-square)](http://badge.fury.io/js/ember-cli-addon-docs)
44
[![Build Status](https://img.shields.io/travis/ember-learn/ember-cli-addon-docs.svg?style=flat-square)](https://travis-ci.org/ember-learn/ember-cli-addon-docs)

addon/components/docs-svg-icon/component.js

+1-1
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@ import Component from '@ember/component';
22
import layout from './template';
33

44
/**
5-
The standard icon class used in addon docs
5+
The standard icon class used in AddonDocs
66
77
@class DocsSvgIcon
88
@public

addon/components/docs-viewer/component.js

+1-1
Original file line numberDiff line numberDiff line change
@@ -6,7 +6,7 @@ import { on } from '@ember/object/evented';
66
import { formElementHasFocus } from '../../keyboard-config';
77

88
/**
9-
The main docs viewer component for Ember-CLI addon docs. This component must be placed
9+
The main docs viewer component for EmberCLI AddonDocs. This component must be placed
1010
1111
1212
```hbs

sandbox/app/components/yuidoc-component.js

+1-1
Original file line numberDiff line numberDiff line change
@@ -20,7 +20,7 @@ let YUIDocComponent = Component.extend({
2020
@argument count
2121
@type number
2222
*/
23-
count: 0,
23+
count: 0,
2424

2525
/**
2626
An action that sends on events

tests/dummy/app/index.html

+1-1
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@
33
<head>
44
<meta charset="utf-8">
55
<meta http-equiv="X-UA-Compatible" content="IE=edge">
6-
<title>Ember CLI Addon Docs</title>
6+
<title>Ember CLI AddonDocs</title>
77
<meta name="description" content="">
88
<meta name="viewport" content="width=device-width, initial-scale=1">
99

tests/dummy/app/pods/docs/deploying/template.md

+5-5
Original file line numberDiff line numberDiff line change
@@ -1,14 +1,14 @@
11
# Deploying
22

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.
44

55
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.
66

77
## Deploying your docs site
88

99
To deploy your docs site to GitHub pages, you'll need to go through a few steps of first-time setup:
1010

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)
1212
2. Set [the `repository` field](https://docs.npmjs.com/files/package.json#repository) of your `package.json`.
1313
3. Commit any outstanding changes you've got on your current branch and push them to GitHub.
1414
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`
3838

3939
## Versioning your content
4040

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.
4242

4343
### Tag deploys
4444

@@ -107,7 +107,7 @@ stages:
107107
108108
## Customizing deploys
109109
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:
111111

112112
```js
113113
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.
145145

146146
### `getPrimaryBranch()`
147147

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`.
149149

150150
## Removing a deployed version
151151

tests/dummy/app/pods/docs/index/template.md

+2-2
Original file line numberDiff line numberDiff line change
@@ -1,10 +1,10 @@
1-
# What is Addon Docs?
1+
# What is AddonDocs?
22

33
Welcome addon author!
44

55
This project was created to help you document and showcase your addon using the accumulated knowledge of the addon community. After surveying several popular project sites we saw that they had much in common, though addon authors have had no easy way to share these techniques.
66

7-
The app you're currently viewing is itself an example of an addon documented using Ember CLI Addon Docs (it is a fortunate dog-fooding position that we find ourselves in). This Ember application employs our thinking on best practices for layout, typography and design, and uses several features like
7+
The app you're currently viewing is itself an example of an addon documented using Ember CLI AddonDocs (it is a fortunate dog-fooding position that we find ourselves in). This Ember application employs our thinking on best practices for layout, typography and design, and uses several features like
88

99
- Support for authoring pages in Markdown (this very page being an example – click *Edit this page* below to view the source)
1010
- Interactive {{#docs-link 'docs.components.docs-hero'}}component demos{{/docs-link}}

tests/dummy/app/pods/docs/patterns/template.md

+3-3
Original file line numberDiff line numberDiff line change
@@ -58,17 +58,17 @@ Typography choices were made primarily for readability. Measure, a typographic t
5858

5959
## Versioning your docs
6060

61-
Addon Docs provides versioned guides out of the box. You can see the version selector in the top-right part of this page. This is provided by the `<docs-header>` component, so your site will get this too assuming you use this component.
61+
AddonDocs provides versioned guides out of the box. You can see the version selector in the top-right part of this page. This is provided by the `<docs-header>` component, so your site will get this too assuming you use this component.
6262

63-
If you look at the [`gh-pages`](https://github.com/ember-learn/ember-cli-addon-docs/tree/gh-pages) branch you'll see that this is where versioned builds of your docs app are stored. Versions are created at deploy time and Addon Docs manages this branch of your repository for you.
63+
If you look at the [`gh-pages`](https://github.com/ember-learn/ember-cli-addon-docs/tree/gh-pages) branch you'll see that this is where versioned builds of your docs app are stored. Versions are created at deploy time and AddonDocs manages this branch of your repository for you.
6464

6565
New versions are created when a new tag is released. There is also a `master` version updated on every deployed commit, and a `Latest` alias that points to the most recent tag, unless it is force-updated to point to `master`.
6666

6767
See the next section on {{docs-link 'deploy guides' 'docs.deploying'}} for more information about deploys.
6868

6969
## Hosting on GitHub Pages
7070

71-
Addon Docs is built for open-source addons deploying their docs sites to GitHub Pages. Once you have this set up, you can even automate deployment as part of your Travis CI builds.
71+
AddonDocs is built for open-source addons deploying their docs sites to GitHub Pages. Once you have this set up, you can even automate deployment as part of your Travis CI builds.
7272

7373
For more details, see the {{docs-link 'Deploying' 'docs.deploying'}} section of the guides.
7474

0 commit comments

Comments
 (0)