Skip to content

docs: declare Standalone APIs as stable#47754

Closed
AndrewKushnir wants to merge 1 commit intoangular:mainfrom
AndrewKushnir:standalone-apis-are-stable
Closed

docs: declare Standalone APIs as stable#47754
AndrewKushnir wants to merge 1 commit intoangular:mainfrom
AndrewKushnir:standalone-apis-are-stable

Conversation

@AndrewKushnir
Copy link
Copy Markdown
Contributor

@AndrewKushnir AndrewKushnir commented Oct 12, 2022

In v14, we've introduced core concepts to allow Components, Directives and Pipes to configure their dependencies without the need to use NgModules and without the need to be declared in an NgModule. The concepts and initial set of APIs were marked as "developer preview" to allow developers to use these APIs and share the feedback.

Since v14, we've been reviewing the entire API surface of the framework and either updating existing APIs to support standalone or creating new APIs that allowed to use Router, HttpClient and other abstractions without NgModules.

Based on the mentioned work to review and stabilize APIs and also based on the positive feedback from the community, we are happy to announce that the Standalone APIs are promoted to stable!

This commit updates vast majority of standalone-related APIs to drop the @developerPreview label, which effectively documents then as stable.

Two APIs that retained the @developerPreview annotations are:

  • withRequestsMadeViaParent (from @angular/common/http)
  • renderApplication (from @angular/platform-server)

We plan to collect some additional feedback for the mentioned APIs and drop the @developerPreview annotation before the next major release.

PR Type

What kind of change does this PR introduce?

  • Feature

Does this PR introduce a breaking change?

  • Yes
  • No

@AndrewKushnir AndrewKushnir added action: review The PR is still awaiting reviews from at least one requested reviewer area: core Issues related to the framework runtime target: major This PR is targeted for the next major release cross-cutting: standalone Issues related to the NgModule-less world labels Oct 12, 2022
@AndrewKushnir AndrewKushnir requested a review from alxhub October 12, 2022 18:36
@ngbot ngbot bot modified the milestone: Backlog Oct 12, 2022
@pullapprove pullapprove bot requested a review from mgechev October 12, 2022 18:36
@angular-robot angular-robot bot added the feature Label used to distinguish feature request from other issues label Oct 12, 2022
@AndrewKushnir AndrewKushnir force-pushed the standalone-apis-are-stable branch from b110d3a to c017960 Compare October 12, 2022 18:41
@AndrewKushnir AndrewKushnir changed the title feat(core): declare Standalone APIs as stable docs: declare Standalone APIs as stable Oct 12, 2022
@angular-robot angular-robot bot added comp: docs and removed feature Label used to distinguish feature request from other issues labels Oct 12, 2022
@AndrewKushnir AndrewKushnir force-pushed the standalone-apis-are-stable branch from c017960 to 1e74123 Compare October 12, 2022 18:45
In v14, we've introduced core concepts to allow Components, Directives and Pipes to configure their dependencies
 without the need to use NgModules and without the need to be declared in an NgModule. The concepts and initial
set of APIs were marked as "developer preview" to allow developers to use these APIs and share the feedback.

Since v14, we've been reviewing the entire API surface of the framework and either updating existing APIs to support standalone or creating new APIs that allowed to use Router, HttpClient and other abstractions without NgMod
ules.

Based on the mentioned work to review and stabilize APIs and also based on the positive feedback from the commun
ity, we are happy to announce that the Standalone APIs are promoted to stable!

This commit updates vast majority of standalone-related APIs to drop the `@developerPreview` label, which effect
ively documents then as stable.

Two APIs that retained the `@developerPreview` annotations are:
- withRequestsMadeViaParent (from `@angular/common/http`)
- renderApplication (from `@angular/platform-server`)

We plan to collect some additional feedback for the mentioned APIs and drop the `@developerPreview` annotation b
efore the next major release.

Co-Authored-By: Alex Rickabaugh <[email protected]>
Co-Authored-By: Andrew Scott <[email protected]>
Co-Authored-By: Dylan Hunn <[email protected]>
Co-Authored-By: Jessica Janiuk <[email protected]>
Co-Authored-By: JoostK <[email protected]>
Co-Authored-By: Kristiyan Kostadinov <[email protected]>
Co-Authored-By: Pawel Kozlowski <[email protected]>
@alan-agius4 alan-agius4 added target: rc This PR is targeted for the next release-candidate and removed target: major This PR is targeted for the next major release labels Oct 13, 2022
@AndrewKushnir AndrewKushnir added action: merge The PR is ready for merge by the caretaker merge: caretaker note Alert the caretaker performing the merge to check the PR for an out of normal action needed or note and removed action: review The PR is still awaiting reviews from at least one requested reviewer labels Oct 14, 2022
@AndrewKushnir
Copy link
Copy Markdown
Contributor Author

Caretaker note: this is a docs-only change, no presubmit is needed. I tried to force g3 status, but it doesn't seem to show up properly on the PR. This PR is ready for merge.

@cyrilletuzi
Copy link
Copy Markdown
Contributor

A feedback after testing standalone APIs by converting a full project: there is a NgModule which seems to have been forgotten and thus still need importProvidersFrom(): ServiceWorkerModule.

@dylhunn
Copy link
Copy Markdown
Contributor

dylhunn commented Oct 17, 2022

This PR was merged into the repository by commit 0d65e1d.

dylhunn pushed a commit that referenced this pull request Oct 17, 2022
In v14, we've introduced core concepts to allow Components, Directives and Pipes to configure their dependencies
 without the need to use NgModules and without the need to be declared in an NgModule. The concepts and initial
set of APIs were marked as "developer preview" to allow developers to use these APIs and share the feedback.

Since v14, we've been reviewing the entire API surface of the framework and either updating existing APIs to support standalone or creating new APIs that allowed to use Router, HttpClient and other abstractions without NgMod
ules.

Based on the mentioned work to review and stabilize APIs and also based on the positive feedback from the commun
ity, we are happy to announce that the Standalone APIs are promoted to stable!

This commit updates vast majority of standalone-related APIs to drop the `@developerPreview` label, which effect
ively documents then as stable.

Two APIs that retained the `@developerPreview` annotations are:
- withRequestsMadeViaParent (from `@angular/common/http`)
- renderApplication (from `@angular/platform-server`)

We plan to collect some additional feedback for the mentioned APIs and drop the `@developerPreview` annotation b
efore the next major release.

Co-Authored-By: Alex Rickabaugh <[email protected]>
Co-Authored-By: Andrew Scott <[email protected]>
Co-Authored-By: Dylan Hunn <[email protected]>
Co-Authored-By: Jessica Janiuk <[email protected]>
Co-Authored-By: JoostK <[email protected]>
Co-Authored-By: Kristiyan Kostadinov <[email protected]>
Co-Authored-By: Pawel Kozlowski <[email protected]>

PR Close #47754
@AndrewKushnir
Copy link
Copy Markdown
Contributor Author

A feedback after testing standalone APIs by converting a full project: there is a NgModule which seems to have been forgotten and thus still need importProvidersFrom(): ServiceWorkerModule.

@cyrilletuzi thanks for the feedback, I've created #47793 to capture this. Please let us know if you might be interested in creating a PR to add a new function.

@angular-automatic-lock-bot
Copy link
Copy Markdown

This issue has been automatically locked due to inactivity.
Please file a new issue if you are encountering a similar or related problem.

Read more about our automatic conversation locking policy.

This action has been performed automatically by a bot.

@angular-automatic-lock-bot angular-automatic-lock-bot bot locked and limited conversation to collaborators Nov 17, 2022
Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.

Labels

action: merge The PR is ready for merge by the caretaker area: core Issues related to the framework runtime cross-cutting: standalone Issues related to the NgModule-less world merge: caretaker note Alert the caretaker performing the merge to check the PR for an out of normal action needed or note target: rc This PR is targeted for the next release-candidate

Projects

None yet

Development

Successfully merging this pull request may close these issues.

7 participants