Advance RFC #0776 "Author Built-In Blueprints in TypeScript" to Stage Recommended

[emberjs-rfcs-bot]

Advance #776 to the Recommended Stage

Summary

This pull request is advancing the RFC to the Recommended Stage.

• PR to Accepted Stage: Author Built-In Blueprints in TypeScript #776
• PR to Ready For Release Stage
• PR to Released Stage

An FCP is required before merging this PR to advance.

Recommended Stage Summary

The "Recommended" stage is the final milestone for an RFC. It provides a signal to the wider community to indicate that a feature has been put through its ecosystem paces and is ready to use.

To reach the "Recommended" stage, the following should be true:

If appropriate, the feature is integrated into the tutorial and the guides prose. API documentation is polished and updates are carried through to other areas of API docs that may not directly pertain to the feature.

If the proposal replaces an existing feature, the addon ecosystem has largely updated to work with both old and new features.

If the proposal updates or replaces an existing feature, high-quality codemods are available.

If needed, Ember debugging tools as well as popular IDE support have been updated to support the feature.

If the feature is part of a suite of features that were designed to work together for best ergonomics, the other features are also ready to be "Recommended".

Any criteria for "Recommended" for this proposal that were established in the Ready For Release stage have been met.

An FCP is required to enter this stage. Multiple RFCs may be moved as a batch into "Recommended" with the same PR.

Checklist to move to Recommended

• Any criteria for "Recommended" for this proposal that were established in the Ready For Release stage have been met
• If appropriate, the feature is integrated into the tutorial and the guides prose. API documentation is polished and updates are carried through to other areas of API docs that may not directly pertain to the feature.
• If the proposal replaces an existing feature, the addon ecosystem has largely updated to work with both old and new features.
• If the proposal updates or replaces an existing feature, high-quality codemods are available
• If needed, Ember debugging tools as well as popular IDE support have been updated to support the feature.
• If the feature is part of a suite of features that were designed to work together for best ergonomics, the other features are also ready to be "Recommended".
• This PR has been converted from a draft to a regular PR and the Final Comment Period label has been added to start the FCP

Criteria for moving to Recommended (required)

A set of criteria for moving this RFC to the Recommended Stage, following release:

• Update guides: This part according to:
  https://github.com/cafreeman/rfcs/blob/typescript-blueprints/text/0776-typescript-blueprints.md#how-we-teach-this

  • PR to add shouldTransformTypescript property to cli.emberjs.com/release/advanced-use/blueprints Add docs for shouldTransformTypescript blueprint property ember-learn/cli-guides#311
  • PR to add --typescript option to cli.emberjs.com/release/advanced-use/cli-commands-reference Add --typescript option to generate command docs ember-learn/cli-guides#312
  • PR to document isTypeScriptProject on https://cli.emberjs.com/release/appendix/configuration/ Update configuration.md with isTypeScriptProject ember-learn/cli-guides#313
  • PR to update the version of the ember-cli api guides so that shouldTransformTypescript documentation is available Update the ember-cli api docs to 5.4.0 ember-learn/ember-cli.github.io#6
  • PR to add a workflow to deploy cli docs on each tag Add a workflow to deploy api docs to ember-learn/ember-cli.github.io ember-cli/ember-cli#10404

• Ember v4.12 is released as stable, as that release enables the feature flag by default

[ef4]

@gitKrystan has volunteered to champion this going forward to make sure it moves.

[gitKrystan]

Per TS core meeting:

Re updating guides, minimally we should add a TS page to the existing guides to cover this and other TS documentation that currently exists in multiple places. This will give people something to react to while we work on a more integrated TS/JS interactive guide.

[gitKrystan]

I've started a PR to the Guides for basic TS documentation. WIP PR here: ember-learn/guides-source#1960

[ef4]

For this particular RFC (which is about blueprint authoring), the remaining piece of docs needed is an update to https://cli.emberjs.com/release/advanced-use/blueprints/

The other TS guides content linked above is great and important for some of the other related TS RFCs, but not a blocker for this one.

[achambers]

PR to add shouldTransformTypescript property to cli.emberjs.com/release/advanced-use/blueprints

ember-learn/cli-guides#311

[achambers]

PR to add --typescript option to https://cli.emberjs.com/release/advanced-use/cli-commands-reference/

ember-learn/cli-guides#312