docs

Summary While auditing the Vue.js documentation for inclusive language, I found one instance of language rooted in the exploitation of animals. The Vue docs are already thoughtful about inclusive language in other respects (the writing guide recommends avoiding terms that "invalidate struggle" and is mindful of cultural sensitivity), so this is a suggestion to extend that care to animal-derived terminology. Finding in (line 61) "Additionally, we publish canary releases every week..." The term "canary release" originates from the practice of sending canaries into coal mines to detect toxic gases — the birds would become sick or die before miners were affected. While this is now a widespread software industry term, it normalizes a historical practice of using animals as disposable tools. Possible alternative: "preview release," "early-access release," or "nightly release" (the docs already use "pre-release" elsewhere on the same page). Note that the upstream npm packages are tagged , so a full change would require coordination with . Context The writing guide at already demonstrates strong awareness of inclusive language: Avoiding terms that invalidate struggle ("easy", "just", "obviously") Cultural sensitivity around humor and idioms Recommending simpler, plainer language over jargon Extending this awareness to animal-derived idioms would be consistent with these existing values. Scope This is a narrow finding — the rest of the documentation is clean of common speciesist idioms (no "dogfooding," "guinea pig," "monkey patching," "kill two birds," "beat a dead horse," "whitelist/blacklist," etc.). The suggestion is specifically about the "canary" terminology. Not requesting This is not a demand or a blocking concern. It's a suggestion for the team to consider as part of the broader trend in tech toward more inclusive and precise language. The alternative terms ("preview," "nightly," "early-access") are arguably clearer to non-native English speakers as well, which aligns with the writing guide's preference for "simpler, plainer language."