cli-guides icon indicating copy to clipboard operation
cli-guides copied to clipboard

Published 20 hours ago • verified publisher icon ember-learn

Document app re-export

Open mehulkar opened this issue 5 years ago • 1 comments

Document why addons re-export everything from addon/ into app/.

mehulkar avatar Oct 03 '20 03:10 mehulkar

If anyone wants to pick up this ticket, here are some suggestions!

This content can be added here: https://cli.emberjs.com/release/writing-addons/#addon

There is a minimal explanation there, but it could be improved. My understanding is that the main reason things are re-exported in app is because the app files in the addon are merged with the app files of the app. This allows Ember devs to use things like addon components using the exact same syntax and patterns they would use if the component existed directly in their own app.

Many times, addon authors have additional files in the addon folder that they do not re-export as public API, so it's good to have the distinction.

jenweber avatar Mar 29 '21 16:03 jenweber