mdn / content

The content behind MDN Web Docs
https://developer.mozilla.org
Other
9.12k stars 22.45k forks source link

Inline status macros: implement new strategy #34738

Open estelle opened 2 months ago

estelle commented 2 months ago

MDN URL

All pages

What specific section or headline is this issue about?

frontmatter

What information was incorrect, unhelpful, or incomplete?

Per https://github.com/orgs/mdn/discussions/654, implement a xmas tree strategy for experimental macros:

If a web feature (interface/CSS property) is experimental a. tag the page with experimental header macro b. also tag each member/value with an experimental badge

If part of the feature is experimental a. don't use the header macro b. use the experimental badge on experimental members/values Tag property/method pages with secure context, irrespective of the interface

What did you expect to see?

new change

Do you have any supporting links, references, or citations?

No response

Do you have anything more you want to share?

No response

OnkarRuikar commented 1 month ago

If a web feature (interface/CSS property) is experimental a. tag the page with an experimental header macro - the bot already does that.

If part of the feature is experimental a. don't use the header macro b. use the experimental badge on experimental members/values

The sync bot already does this.

b. also tag each member/value with an experimental badge

This was supposed to be handled by BCD linter. For now I've updated the bot script. Content changes are being pulled here https://github.com/mdn/content/pull/34883

Tag property/method pages with secure context, irrespective of the interface

Secure context automation hasn't been implemented. So it has to be enforced by the authors/reviewers. Curren inconsistencies have been fixed in https://github.com/mdn/content/pull/34885


Working on updating writing guidelines.