ember-doc-engine

ember-doc-engine is a documentation tool targeted at Ember add-on developers.

It uses YUIDoc to generate documentation JSON files and consumes it as an Ember engine. As such, ember-doc-engine is able to consume YUIDoc JSON files from other projects, and let you cross link between multiple projects.

Installation

ember install ember-doc-engine

Configuration

Add a DOCS property to your add-on's config.

// config/environment.js
module.exports = function(environment/* , appConfig */) {
  const ENV = {
    modulePrefix: 'ember-doc-engine',
    environment: environment
  };

  ENV.DOCS = {
    'ember': 'ember.json',
    'ember-doc-engine': 'ember-doc-engine.json'
  };

  return ENV;
};

Add an entry to the DOCS property for each project that you like to link to your documentation. They key is the slug you'll be using for the project and the value is the url to the YUIDoc json file.

Don't forget to add your own project!

Lastly, you'll need to mount the docs engine in your app.

Router.map(function() {
  this.mount('ember-doc-engine', { resetNamespace: true, path: '/docs' });
});