Guidelines don't mention "non-normative" sections
Nobody has claimed this yet.
- Dominant language
- JSON
- Stars
- 5.8k
- Forks
- 2.6k
- Avg merge
- 1d 21h
- Merged PRs (30d)
- 186
Description
What would you like to see added to BCD
The guidelines should mention that behaviors mentioned in non-normative section generally don't qualify for inclusion in BCD.
Given that there seem to be exceptions (e.g. date picker UI showing min/max constraints), it would be nice to mention that these can added as non-standard features.
How impactful do you think this enhancement will be
Make it easier to triage/handle requests like https://github.com/mdn/browser-compat-data/issues/28397.
Do you have anything more you want to share
No response
Contributor guide
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
Research direction
Review the existing BCD guidelines and issue #28397 first to understand the triage context. Update the guidelines to explain how non-normative sections are generally handled and note the possible non-standard-feature exception. Done means the guidance clearly supports handling requests like #28397.
Written by the indexing model from the issue text.
Assessment
- Domain
- documentation
- Issue type
- Documentation
- Difficulty
- 2/5
- Estimated time
- 1-3 hours
- Activity status
- Stale
- Clarity
- Mostly clear
- Newbie friendliness
- 45/100