docs: clarify Baseline Widely Available browser support wording#21689
Open
darshjme-codes wants to merge 1 commit intovitejs:mainfrom
Open
docs: clarify Baseline Widely Available browser support wording#21689darshjme-codes wants to merge 1 commit intovitejs:mainfrom
darshjme-codes wants to merge 1 commit intovitejs:mainfrom
Conversation
Fixes vitejs#21144 ## Problem The documentation stated: "These are browsers that were released at least 2.5 years ago." This wording is confusing because: - It focuses on browser release dates rather than feature availability - "At least 2.5 years ago" is ambiguous (could mean older browsers) - Doesn't clearly explain what "Baseline Widely Available" means ## Solution Rephrase to focus on feature availability: "This means it only uses features which have been available across browsers for at least 2.5 years." This clarifies that: - Vite uses features that have 2.5+ years of browser support - The focus is on feature maturity, not browser age - Aligns with the Baseline Widely Available definition ## Impact - Clearer understanding of Vite's browser support strategy - Matches the intent of Baseline Widely Available (features with broad, established support) - Reduces confusion for developers evaluating Vite's compatibility
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Fixes #21144
Problem
The documentation stated:
This wording is confusing because:
Solution
Rephrase to focus on feature maturity instead of browser age:
Why This is Clearer
✅ Focuses on features (what developers care about), not browser versions
✅ Aligns with Baseline Widely Available definition (features with broad, established support)
✅ Removes ambiguity - "available for 2.5 years" is clear vs "released 2.5 years ago"
Impact
Credit to @leonardt for identifying this confusing wording.