Skip to content

docs(quickstart): remove zoneless note and recommend zoneless - #1452

Draft
chintankavathia wants to merge 1 commit into
mainfrom
docs/quick-start/zoneless
Draft

docs(quickstart): remove zoneless note and recommend zoneless#1452
chintankavathia wants to merge 1 commit into
mainfrom
docs/quick-start/zoneless

Conversation

@chintankavathia

@chintankavathia chintankavathia commented Feb 5, 2026

Copy link
Copy Markdown
Member

Describe in detail what your merge request does and why. Add relevant
screenshots and reference related issues via Closes #XY or Related to #XY.


@gemini-code-assist gemini-code-assist Bot 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.

Code Review

This pull request updates the quickstart guide to recommend using a zoneless Angular application. The changes correctly modify the ng new command example and the corresponding app.config.ts setup by removing zone.js related configurations. My review includes one suggestion to improve the documentation by explicitly stating the recommendation for a zoneless setup and providing a brief rationale, which would enhance clarity for users following the guide and aligns with the rule of explaining 'the why' before 'the how'.

Comment thread docs/get-started/quickstart.md Outdated

Answer the following questions as desired. Note: We are not yet
[Zoneless](https://angular.dev/guide/zoneless).
Answer the following questions as desired.

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.

medium

While the example now correctly shows 'Yes' for a zoneless application, the accompanying text could be improved. The previous note about not being zoneless was removed, but now there's no explanation for the new recommendation. To enhance clarity, it's beneficial to explicitly state the recommendation for a zoneless setup and briefly explain the benefits (e.g., performance). This aligns with the general rule of explaining 'the why' before 'the how'.

Suggested change
Answer the following questions as desired.
Answer the following questions as desired. We recommend creating a zoneless application for better performance and a more modern Angular setup.
References
  1. In documentation, it is preferable to introduce a concept ('the why') before detailing the technical specifics ('the how') to enhance readability, even if this leads to some repetition.

@chintankavathia
chintankavathia force-pushed the docs/quick-start/zoneless branch from 0538019 to 0a921d3 Compare February 5, 2026 06:53
@github-actions

github-actions Bot commented Feb 5, 2026

Copy link
Copy Markdown

Code Coverage

@github-actions

github-actions Bot commented Feb 5, 2026

Copy link
Copy Markdown

@spike-rabbit spike-rabbit added this to the 51.x milestone Jul 8, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants