peterchoo / ember-cli-yuidoc

EmberCLI addon for generate documentation from YUIDoc coments

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

Ember-cli-yuidoc

This is an ember-cli addon for generate html documentation from YUIDoc comments in the source code

Installation

Just npm install --save-dev ember-cli-yuidoc. This plugin expects to find a yuidoc.json manifest on the root of your project. You can generate one automatically with ember g yuidoc.

Running

This addon adds a new yuidoc command to ember-cli. To generate the documentation just run ember yuidoc Documentation is generated in the /docs folder by default. You might want to add this folder to the gitignore.

Also, for live updating, when you run ember serve you can visit the /docs url to see it.

Running Tests

No tests yet

TODOS

  • Allow to pass parameters to ember yuidoc and forward them to the yuidoc executable.
  • Allow to customize the folder where the code lives (right now only addon and app).
  • Allow to opt-out to live doc generation in ember serve

About

EmberCLI addon for generate documentation from YUIDoc coments