# Ember CLI Addon Docs: Shared Documentation for the Ember Ecosystem

DevFeed: [Ember CLI Addon Docs: Shared Documentation for the Ember Ecosystem](<https://devfeed.tech/articles/ember-cli-addon-docs-shared-documentation-for-the-ember-ecosystem-30542.md>)

Original publisher: [Read original article](<https://medium.com/build-addepar/ember-cli-addon-docs-shared-documentation-for-the-ember-ecosystem-6f29aa0cee87?source=rss----596e43e5e150---4>)

Author: pzuraq

Published: 2018-03-07T21:00:37Z

Content type: article

Language: en

Sources: [Addepar](<https://devfeed.tech/sources/addepar.md>)

Topics: [Ember](<https://devfeed.tech/topics/ember.md>), [Documentation](<https://devfeed.tech/topics/documentation.md>), [code productivity](<https://devfeed.tech/topics/code-productivity.md>), [JavaScript](<https://devfeed.tech/topics/javascript.md>)

Tags: [automated](<https://devfeed.tech/tags/automated.md>), [developer-productivity](<https://devfeed.tech/tags/developer-productivity.md>), [documentation](<https://devfeed.tech/tags/documentation.md>), [ember](<https://devfeed.tech/tags/ember.md>), [ember-cli](<https://devfeed.tech/tags/ember-cli.md>), [emberjs](<https://devfeed.tech/tags/emberjs.md>), [examples](<https://devfeed.tech/tags/examples.md>), [experimental](<https://devfeed.tech/tags/experimental.md>), [full-text-search](<https://devfeed.tech/tags/full-text-search.md>)

## AI overview

Addepar describes the development of ember-cli-addon-docs, a shared documentation solution for Ember addons. The project addresses limitations in existing tools by providing Ember-focused API documentation, Markdown templates, live demos, versioning, automated deployments, search, and pluggable API documentation generators.

## Source excerpt

On our road to modern Ember here at Addepar, we've been hard at work developing a new component library to replace a lot of our older components, such as the now deprecated Ember Widgets library. As anyone who has built a shared toolset of components will know, one of the more tedious tasks faced by a library developer is documentation -- users of the new components need to be able to reference the APIs to know how to use them, and having a single source of truth for your docs is invaluable to developer productivity, but setting up docs in the first place is a lot of hard work! For Ember, part of the problem is that there is no standard documentation solution as of yet. The core Ember and Ember-CLI API docs use YUIDoc to generate docs automatically, but it is an aging library which doesn't have much support for modern javascript features. JSDoc is also falling behind the times lately, and newer doc tools like ESDoc and Documentation.js are still too experimental for widespread use. Moreover, none of these tools targets Ember -- they are meant for generic Javascript usage and don't highlight things that Ember devs need to know, like what arguments a component receives, what actions it sends, or what values it yields. Worse yet, none of these tools has support for live examples and demos. To get those, most addon authors resort to building an Ember app, usually using the test application (or Dummy app) included with the addon. Building an app takes time and effort, and in the end this means that very few addons in the ecosystem are fully documented with good examples and well described APIs. When we started to set up our documentation we ran into all of these issues, and we began wondering where the shared solution was for Ember documentation. As often happens in the Ember community, it turned out others had been wondering this as well! We joined forces with Sam Selikoff, Dan Freeman, and the Ember Learning team to work on ember-cli-addon-docs, a project whose goal is t