Skip to content

docs: clarify side effects in the watcher introduction - #3487

Open
Doomguy-BFG9000 wants to merge 1 commit into
vuejs:mainfrom
Doomguy-BFG9000:docs/3345-explain-side-effects
Open

Doomguy-BFG9000 wants to merge 1 commit into
vuejs:mainfrom
Doomguy-BFG9000:docs/3345-explain-side-effects

Conversation

@Doomguy-BFG9000

Copy link
Copy Markdown

Description of Problem

The Watchers introduction uses "side effects" before explaining the term, making the comparison with computed properties unclear.

Closes #3345.

Proposed Solution

Explain the distinction between computing a value and responding to state changes by changing other state, then introduce the existing term "side effects". The examples and APIs are unchanged.

Additional Information

Validation: pnpm@10.33.0 run build passed with Node 25 experimental web storage disabled. The changed paragraph was checked in headless Chrome at 1440px and 390px; no horizontal overflow or page errors were observed.

@netlify

netlify Bot commented Nov 6, 2026 •

Copy link
Copy Markdown

✅ Deploy Preview for vuejs ready!

Name Link
🔨 Latest commit 83832ff
🔍 Latest deploy log https://app.netlify.com/projects/vuejs/deploys/6aed662836fc8e98224299ed
😎 Deploy Preview https://deploy-preview-3487--vuejs.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify project configuration.

This branch has not been deployed

No deployments
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.

Issue with unclear reference point for "side effects" in the documentation

1 participant