Start a documentation website using ember-cli-addon-docs

config/deploy.js

@@ -0,0 +1,28 @@
+/* jshint node: true */
+
+module.exports = function(deployTarget) {
+  var ENV = {
+    build: {}
+    // include other plugin configuration that applies to all deploy targets here
+  };
+
+  if (deployTarget === 'development') {
+    ENV.build.environment = 'development';
+    // configure other plugins for development deploy target here
+  }
+
+  if (deployTarget === 'staging') {
+    ENV.build.environment = 'production';
+    // configure other plugins for staging deploy target here
+  }
+
+  if (deployTarget === 'production') {
+    ENV.build.environment = 'production';
+    // configure other plugins for production deploy target here
+  }
+
+  // Note: if you need to build some configuration asynchronously, you can return
+  // a promise that resolves with the ENV object instead of returning the
+  // ENV object synchronously.
+  return ENV;
+};

config/environment.js

@@ -2,5 +2,9 @@
 'use strict';
 
 module.exports = function(/* environment, appConfig */) {
-  return { };
+  return {
+    'ember-cli-mirage': {
+      enabled: true, // always enable mirage, even in production
+    },
+  };
 };

package.json

@@ -26,7 +26,11 @@
     "ember-ajax": "^3.0.0",
     "ember-chrome-devtools": "^0.1.1",
     "ember-cli": "2.13.2",
+    "ember-cli-addon-docs": "https://github.com/ember-learn/ember-cli-addon-docs",
     "ember-cli-dependency-checker": "^1.3.0",
+    "ember-cli-deploy": "^1.0.1",
+    "ember-cli-deploy-build": "^1.1.0",
+    "ember-cli-deploy-git": "^1.1.1",
     "ember-cli-eslint": "^3.0.0",
     "ember-cli-htmlbars": "^1.1.1",
     "ember-cli-htmlbars-inline-precompile": "^0.4.0",
@@ -46,7 +50,7 @@
     "loader.js": "^4.2.3"
   },
   "engines": {
-    "node": ">= 4"
+    "node": "^6.11.1"
   },
   "ember-addon": {
     "configPath": "tests/dummy/config"

tests/dummy/app/router.js

@@ -7,6 +7,17 @@ const Router = Ember.Router.extend({
 });
 
 Router.map(function() {
+  // Documentation
+  this.route('docs', function() {
+    this.route('quickstart');
+    this.route('patterns');
+    this.route('cookbook', function() {
+      this.route('queries');
+      this.route('relationships');
+    });
+  });
+
+  // Tests
   this.route('posts');
   this.route('post', { path: '/posts/:slug' });
 });

tests/dummy/app/templates/application.hbs

@@ -1 +1,7 @@
+{{docs-navbar
+  logo="ember"
+  name="Data Url Templates"
+  githubUrl="https://github.com/amiel/ember-data-url-templates"
+}}
+
 {{outlet}}

tests/dummy/app/templates/docs.hbs

@@ -0,0 +1,24 @@
+{{#docs-viewer as |viewer|}}
+
+  {{#viewer.nav as |nav|}}
+    {{nav.item 'Home' 'docs.index'}}
+    {{nav.item 'Quickstart' 'docs.quickstart'}}
+    {{nav.item 'Patterns' 'docs.patterns'}}
+
+    {{#nav.subnav as |nav|}}
+      {{nav.item 'query and queryRecord' 'docs.cookbook.queries'}}
+      {{nav.item 'relationships' 'docs.cookbook.relationships'}}
+    {{/nav.subnav}}
+
+    <!-- {{nav.item 'API Reference' 'docs.api'}} -->
+  {{/viewer.nav}}
+
+  {{#viewer.main}}
+    <div class="docs-container docs__center docs-md">
+      <div class="docs-section">
+        {{outlet}}
+      </div>
+    </div>
+  {{/viewer.main}}
+
+{{/docs-viewer}}

tests/dummy/app/templates/docs/index.md

@@ -0,0 +1,23 @@
+# Introduction
+
+Coming soon.
+
+## Installation
+
+```sh
+ember install ember-data-url-templates
+```
+
+Then, import and mixin `ember-data-url-templates` to your adapter. For example, to use url templates in all adapters by default,
+
+```js
+// app/adapters/application.js
+
+import DS from 'ember-data';
+import UrlTemplates from 'ember-data-url-templates';
+
+export default DS.JSONAPIAdapter.extend(UrlTemplates, {
+});
+```
+
+

tests/dummy/app/templates/docs/quickstart.md

@@ -0,0 +1 @@
+# Coming soon

tests/dummy/app/templates/index.hbs

@@ -0,0 +1,44 @@
+{{docs-hero
+  logo="ember-data"
+  slim-heading='URL'
+  strong-heading='Templates'
+  byline='build urls with templates instead of defining buildURL'
+}}
+
+
+<div class='docs-container docs-md'>
+  <section class='docs-section'>
+
+    <aside>Looking for the quickstart? {{link-to 'Click here' 'docs.quickstart'}}.</aside>
+
+    <p>
+      ember-data-url-templates is an addon to allow building urls with url templates instead of defining <code>buildURL</code> as described in <a href="https://github.com/emberjs/rfcs/pull/4" target="_blank" rel="noopener">emberjs/rfcs#4</a>.
+    </p>
+
+    <pre>
+      <code>
+        // app/adapters/comment.js
+
+        import Ember from "ember";
+        import DS from "ember-data";
+        import UrlTemplates from "ember-data-url-templates";
+
+        export default DS.RESTAdapter.extend(UrlTemplates, {
+          urlTemplate: '{+host}/comments{/id}',
+          queryUrlTemplate: '{+host}/comments{?query*}',
+          createRecordUrlTemplate: '{+host}/users/{userId}/comments',
+
+          session: Ember.inject.service(),
+
+          urlSegments: {
+            userId() {
+              return this.get('session.userId');
+            }
+          }
+        });
+      </code>
+    </pre>
+
+  </section>
+</div>
+

tests/dummy/mirage/scenarios/default.js

@@ -1,11 +1,3 @@
-export default function(/* server */) {
-
-  /*
-    Seed your development database using your factories.
-    This data will not be loaded in your tests.
-
-    Make sure to define a factory for each model you want to create.
-  */
-
-  // server.createList('post', 10);
+export default function(server) {
+  server.createList('post', 10);
 }