[DOC Release] Mark @ember/instrumentation as public#17848
[DOC Release] Mark @ember/instrumentation as public#17848xg-wang wants to merge 1 commit intoemberjs:masterfrom
Conversation
|
I do think the module itself should be importable (if it's not already), but I'm not sure that we should mark the methods as public. I was under the impression that they are in a similar state as the |
|
@chancancode What would be the difference if we mark the module as public but not the methods? |
|
From the RFC:
And the RFC enumerated what should be exported as public API: |
|
I think the context was that we agreed to give some reasonably popular intimate APIs an import path (so that they can be used at all), without necessarily committing to semver API stability. There are other private things on there too, e.g. |
|
We chatted about this for a bit at the most recent core team meeting. The rough consensus is that these APIs are not what we would prefer them to be, and instead of making them public now we should consider coming up with better alternatives. To be clear, this does not mean that the |
|
@xg-wang thank you for spurring the conversation here! I'm going to go ahead and close this PR now that we've discussed and come to a conclusion. |
Based on description in https://github.com/emberjs/rfcs/blob/master/text/0176-javascript-module-api.md#organize-by-mental-model,
@ember/instrumentationis deemed as public module.#11362 may have incorrectly marked it as private.
Closes #17703
cc/ @chadhietala