Skip to content

docs: Add error boundaries entries - #70560

Merged
atscott merged 1 commit into
angular:mainfrom
JeanMeche:error-boundary-docs
Sep 10, 2026
Merged

atscott merged 1 commit into
angular:mainfrom
JeanMeche:error-boundary-docs

Conversation

@JeanMeche

@JeanMeche JeanMeche commented Sep 3, 2026

Copy link
Copy Markdown
Member

No description provided.

@angular-robot angular-robot Bot added the area: docs Related to the documentation label Sep 3, 2026
@ngbot ngbot Bot added this to the Backlog milestone Sep 3, 2026
Comment thread adev/src/content/guide/templates/error-boundaries.md Outdated
Comment thread adev/src/content/guide/templates/error-boundaries.md Outdated
Comment thread adev/src/content/guide/templates/error-boundaries.md Outdated
Error handling isn't limited to template syntax. If you are creating components or embedded views dynamically using `ViewContainerRef` or the standalone `createComponent` function, you can provide an `onError` callback in the options object. This callback functions identically to an `@error` block but for imperatively created views.

```ts
viewContainerRef.createComponent(DynamicComponent, {

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I think we can also avoid the "Component" suffix here

Suggested change
viewContainerRef.createComponent(DynamicComponent, {
viewContainerRef.createComponent(Dynamic, {

Comment thread tools/manual_api_docs/blocks/boundary.md Outdated
Comment thread adev/src/content/guide/templates/error-boundaries.md Outdated
Comment thread adev/src/app/routing/navigation-entries/index.ts
Comment thread adev/src/content/guide/templates/error-boundaries.md Outdated

@atscott atscott left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

AGENT: Thank you for putting together the documentation for @boundary!

Overall, the content is well-structured and provides a clear overview of error boundaries in Angular templates. I have left inline suggestions focused on alignment with the Angular Documentation Style Guide and Google Technical Writing guidelines (sentence case in headings, present tense instead of future "will", active voice, avoiding Latin abbreviations and casual idioms).

Key highlights:

  • tools/manual_api_docs/blocks/boundary.md: Note that $retry was updated to $reset in the compiler/runtime primitives. I have flagged this inline so the syntax matches the actual compiler implementation.
  • Section deduplication: The "Dynamic views and programmatic error handling" section is currently duplicated in full between error-boundaries.md and programmatic-rendering.md. Consider linking from error-boundaries.md to programmatic-rendering.md#handling-rendering-errors to maintain a single source of truth.
  • Commit message headline: Minor note for whenever rebasing/squashing: per the commit message guidelines, headline summaries should not be capitalized (docs: add error boundaries entries).

Comment thread tools/manual_api_docs/blocks/boundary.md Outdated
Comment thread tools/manual_api_docs/blocks/boundary.md Outdated
Comment thread tools/manual_api_docs/blocks/boundary.md Outdated
Comment thread adev/src/content/guide/templates/error-boundaries.md Outdated
Comment thread adev/src/content/guide/templates/error-boundaries.md Outdated
Comment thread adev/src/content/guide/templates/error-boundaries.md Outdated
Comment thread adev/src/content/guide/templates/error-boundaries.md Outdated
Comment thread adev/src/content/guide/templates/error-boundaries.md Outdated
Comment thread adev/src/content/guide/templates/error-boundaries.md Outdated
Comment thread adev/src/content/guide/components/programmatic-rendering.md
Comment thread tools/manual_api_docs/blocks/boundary.md Outdated
@JeanMeche JeanMeche added action: merge The PR is ready for merge by the caretaker target: minor This PR is targeted for the next minor release labels Sep 10, 2026
@atscott
atscott merged commit e205075 into angular:main Sep 10, 2026
24 of 27 checks passed
@atscott

atscott commented Sep 10, 2026

Copy link
Copy Markdown
Contributor

This PR was merged into the repository. The changes were merged into the following branches:

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

action: merge The PR is ready for merge by the caretaker adev: preview area: docs Related to the documentation target: minor This PR is targeted for the next minor release

Projects

None yet

Development

Successfully merging this pull request may close these issues.

5 participants