Skip to content

docs: add CSS data guidelines - #30198

Open
BHUVANSH855 wants to merge 1 commit into
mdn:mainfrom
BHUVANSH855:fix-28913-css-guidelines
Open

docs: add CSS data guidelines#30198
BHUVANSH855 wants to merge 1 commit into
mdn:mainfrom
BHUVANSH855:fix-28913-css-guidelines

Conversation

@BHUVANSH855

Copy link
Copy Markdown
Contributor

Summary

  • Add CSS-specific BCD data guidelines.
  • Document how to model CSS at-rules, properties, selectors, and types.
  • Clarify when CSS types, values, functions, and syntax should be represented as separate features or subfeatures.
  • Document that specification grammar alone is not sufficient reason to create a BCD feature.
  • Add examples based on existing CSS compatibility data and recent BCD discussions.

Test results and supporting details

  • npm run format — passed after formatting the new guideline.
  • npm run lint — passed; all BCD data passed linting.
  • eslint — 0 errors; existing warnings only.
  • tsc --noEmit — passed.
  • Prettier — passed.
  • git diff --cached --check — passed.

The guidelines were informed by existing CSS BCD data and the discussions in #28838, #29034, and #6349.

Related issues

Fixes #28913

Related:

@github-actions github-actions Bot added docs Issues or pull requests regarding the documentation of this project. size:m [PR only] 25-100 LoC changed labels Aug 9, 2026
@github-actions

github-actions Bot commented Aug 9, 2026

Copy link
Copy Markdown
Contributor

Tip: Review these changes grouped by change (recommended for most PRs), or grouped by feature (for large PRs).

@Elchi3 Elchi3 added the meeting agenda Issues or pull requests in need of discussion in a project meeting. label Aug 11, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

docs Issues or pull requests regarding the documentation of this project. meeting agenda Issues or pull requests in need of discussion in a project meeting. size:m [PR only] 25-100 LoC changed

Projects

Status: Todo

Development

Successfully merging this pull request may close these issues.

Add guidelines for CSS support data

2 participants