@condenast/ember-docs

Creates documentation from Ember apps / addons

Downloads in past

Stats

StarsIssuesVersionUpdatedCreatedSize
@condenast/ember-docs
0.1.84 years ago4 years agoMinified + gzip package size for @condenast/ember-docs in KB

Readme

ember-docs Build Status Maintainability Test Coverage
:warning: This library is in progress and shouldn't be used quite yet. :warning:
ember-docs is a library to generate better documentation for Ember applications, using Ember's strong conventions to enhance JSDoc.

Installation

npm install @condenast/ember-docs

Why?

Ember has strong conventions, so we wanted to bring those conventions to writing documentation for Ember apps and Ember addons. Since the conventions are so strong, we can remove a lot of requirements of documentation engines and pull the information directly from code.

:sparkles: Magic :sparkles:

:pointright: No need to name files or define access on them.
app/helpers/equals.js is automatically detected as a public helper named equals because it's in the correct spot for an Ember helper.

app/helpers/-in-element.js is detected as a private helper because of the preceding -.

:point
right: No need to duplicate parameter structure in components & helpers.
Positional and named parameters are pulled from component and helper definitions and provided for you.

:pointright: Defaults are pulled from code
Default parameters are pulled from the code so you don't need to to define them twice. (Yes, you can override this)