ember-docs
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.
✨ Magic ✨
app/helpers/equals.js
is automatically detected as a public helper namedequals
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-
.
Positional and named parameters are pulled from component and helper definitions and provided for you.
Default parameters are pulled from the code so you don't need to to define them twice. (Yes, you can override this)