Detailed API Documentation Review: ember-htmlbars -> ember-glimmer

[rwjblue]

All of the functionality of our templating system has been migrated from ember-htmlbars to ember-glimmer package. We need to ensure that we have not lost significant documentation coverage.

At a minimum we need to review the following files in ember-htmlbars to confirm that all documentation contained within them has been migrated to the ember-glimmer package.

• packages/ember-htmlbars/lib/component.js
• packages/ember-htmlbars/lib/helper.js
• packages/ember-htmlbars/lib/helpers/-html-safe.js
• packages/ember-htmlbars/lib/helpers/concat.js
• packages/ember-htmlbars/lib/helpers/each-in.js
• packages/ember-htmlbars/lib/helpers/each.js
• packages/ember-htmlbars/lib/helpers/hash.js
• packages/ember-htmlbars/lib/helpers/if_unless.js
• packages/ember-htmlbars/lib/helpers/log.js
• packages/ember-htmlbars/lib/helpers/query-params.js
• packages/ember-htmlbars/lib/helpers/with.js
• packages/ember-htmlbars/lib/helpers.js
• packages/ember-htmlbars/lib/hooks/bind-local.js
• packages/ember-htmlbars/lib/hooks/bind-self.js
• packages/ember-htmlbars/lib/hooks/bind-shadow-scope.js
• packages/ember-htmlbars/lib/hooks/classify.js
• packages/ember-htmlbars/lib/hooks/cleanup-render-node.js
• packages/ember-htmlbars/lib/hooks/concat.js
• packages/ember-htmlbars/lib/hooks/destroy-render-node.js
• packages/ember-htmlbars/lib/hooks/element.js
• packages/ember-htmlbars/lib/hooks/get-child.js
• packages/ember-htmlbars/lib/hooks/get-root.js
• packages/ember-htmlbars/lib/hooks/get-value.js
• packages/ember-htmlbars/lib/hooks/link-render-node.js
• packages/ember-htmlbars/lib/hooks/subexpr.js
• packages/ember-htmlbars/lib/hooks/update-self.js
• packages/ember-htmlbars/lib/index.js
• packages/ember-htmlbars/lib/keywords/action.js
• packages/ember-htmlbars/lib/keywords/closure-component.js
• packages/ember-htmlbars/lib/keywords/component.js
• packages/ember-htmlbars/lib/keywords/debugger.js
• packages/ember-htmlbars/lib/keywords/get.js
• packages/ember-htmlbars/lib/keywords/input.js
• packages/ember-htmlbars/lib/keywords/mount.js
• packages/ember-htmlbars/lib/keywords/mut.js
• packages/ember-htmlbars/lib/keywords/outlet.js
• packages/ember-htmlbars/lib/keywords/partial.js
• packages/ember-htmlbars/lib/keywords/readonly.js
• packages/ember-htmlbars/lib/keywords/render.js
• packages/ember-htmlbars/lib/keywords/textarea.js
• packages/ember-htmlbars/lib/keywords/unbound.js
• packages/ember-htmlbars/lib/keywords/with.js
• packages/ember-htmlbars/lib/keywords.js
• packages/ember-htmlbars/lib/streams/class_name_binding.js
• packages/ember-htmlbars/lib/streams/dependency.js
• packages/ember-htmlbars/lib/streams/stream.js
• packages/ember-htmlbars/lib/streams/subscriber.js
• packages/ember-htmlbars/lib/streams/utils.js
• packages/ember-htmlbars/lib/system/instrumentation-support.js
• packages/ember-htmlbars/lib/system/lookup-helper.js
• packages/ember-htmlbars/lib/utils/is-component.js
• packages/ember-htmlbars/lib/views/outlet.js

More specifically, we need to do the following for each file listed above:

• Identify if the file contains any API documention (generally identified by the presence of a comment block with YUIDoc syntax).
• Check if the documentation is present somewhere within the ember-glimmer package. If not, submit a pull request with the missing documentation (linking back here). If it is, comment below so that we can mark the file complete.

@emberjs/learning-team-managers - Can you help coordinate this effort?

[rwjblue]

You can find the most recent version of the ember-htmlbars package (prior to removal) in the backup/canary-2-9-with-htmlbars branch.

[toddjordan]

I can provide some help here... @rwjblue you mean "confirm that the documentation is present", right?

[rwjblue]

LOL, yes. I mean that if it is already present we check the box next to the file name. If it is not present we submit a PR adding it then check the box. (updated the description to be clearer)

[krisselden]

Should we use ember-glimmer instead of ember-templates to document things?

Also, should we remap the global export for Ember.HTMLBars? to Ember.Template?

[chancancode]

@krisselden ember-templates has been removed on master, so I think it's a yes for the first question

[rwjblue]

@chancancode - The usage of Ember.Templates in the docs predates the presence of an ember-templates package in the codebase.

[toddjordan]

Working through html-bars/lib/component.js, html-bars/lib/helper.js, and html-bars/lib/helpers/* today.

[toddjordan]

took on the rest of these as well in pr #14200

There was a few files in htmlbars that didn't have a logical place to doc in glimmer. I listed these in the PR. I also combined ember-htmlbars and ember-templates modules under ember-glimmer. would like feedback.

[toddjordan]

pr #14200 should now address remaining checkboxes

[acorncom]

@toddjordan Should we close this issue now?

[toddjordan]

Think so if ok with @rwjblue

[rwjblue]

Sorry for the delay here, thanks for all the hard work here!