Merge branch 'main' into fix-31817

.github/CODEOWNERS

@@ -1,83 +1,57 @@
-# ----------------------------------------------------------------------------
-# MDN Content CODEOWNERS
-# ----------------------------------------------------------------------------
-# Order is important. The last matching pattern takes precedence. For more
-# detailed information, see:
+# Order is important: The last matching pattern takes precedence.
+# For more detailed information, see:
 # https://docs.github.com/en/free-pro-team@latest/github/creating-cloning-and-archiving-repositories/about-code-owners
-# ----------------------------------------------------------------------------
 
-# ----------------------------------------------------------------------------
-# DEFAULT OWNERS
-# ----------------------------------------------------------------------------
-*    @mdn/core-yari-content
+# Default owners
+* @mdn/core-yari-content
 
-# ----------------------------------------------------------------------------
-# DEFAULT ENGLISH CONTENT OWNER(S)
-# ----------------------------------------------------------------------------
-/files/en-us/    @mdn/yari-content-mdn
+# Default content owners
+/files/en-us/ @mdn/yari-content-mdn
 
-# ----------------------------------------------------------------------------
-# ENGLISH WEB ACCESSIBILITY CONTENT OWNER(S)
-# ----------------------------------------------------------------------------
-/files/en-us/web/accessibility/    @mdn/yari-content-accessibility
-/files/en-us/learn/accessibility/    @mdn/yari-content-accessibility
+# Accessibility
+/files/en-us/web/accessibility/ @mdn/yari-content-accessibility
+/files/en-us/learn/accessibility/ @mdn/yari-content-accessibility
 
-# ----------------------------------------------------------------------------
-# ENGLISH CSS CONTENT OWNER(S)
-# ----------------------------------------------------------------------------
-/files/en-us/web/css/    @mdn/yari-content-css
-/files/en-us/learn/css/    @mdn/yari-content-css
+# CSS
+/files/en-us/web/css/ @mdn/yari-content-css
+/files/en-us/learn/css/ @mdn/yari-content-css
 
-# ----------------------------------------------------------------------------
-# ENGLISH HTML CONTENT OWNER(S)
-# ----------------------------------------------------------------------------
-/files/en-us/web/html/    @mdn/yari-content-html
-/files/en-us/learn/html/    @mdn/yari-content-html
+# HTML
+/files/en-us/web/html/ @mdn/yari-content-html
+/files/en-us/learn/html/ @mdn/yari-content-html
 
-# ----------------------------------------------------------------------------
-# ENGLISH JAVASCRIPT CONTENT OWNER(S)
-# ----------------------------------------------------------------------------
-/files/en-us/web/javascript/    @mdn/yari-content-javascript
-/files/en-us/learn/javascript/    @mdn/yari-content-javascript
+# JavaScript
+/files/en-us/web/javascript/ @mdn/yari-content-javascript
+/files/en-us/learn/javascript/ @mdn/yari-content-javascript
 
-# ----------------------------------------------------------------------------
-# ENGLISH HTTP CONTENT OWNER(S)
-# ----------------------------------------------------------------------------
-/files/en-us/web/http/    @mdn/yari-content-http
-/files/en-us/learn/server-side/    @mdn/yari-content-http
+# HTTP
+/files/en-us/web/http/ @mdn/yari-content-http
+/files/en-us/learn/server-side/ @mdn/yari-content-http
 
-# ----------------------------------------------------------------------------
-# ENGLISH WEB API CONTENT OWNER(S)
-# ----------------------------------------------------------------------------
-/files/en-us/web/api/    @mdn/yari-content-web-api
+# Web API
+/files/en-us/web/api/ @mdn/yari-content-web-api
 
-# ----------------------------------------------------------------------------
-# ENGLISH SVG CONTENT OWNER(S)
-# ----------------------------------------------------------------------------
-/files/en-us/web/svg/    @mdn/yari-content-svg
+# Mozilla Add-ons
+/files/en-us/mozilla/add-ons/ @mdn/yari-content-mozilla-add-ons
 
-# ----------------------------------------------------------------------------
-# ENGLISH MOZILLA ADD-ONS CONTENT OWNER(S)
-# ----------------------------------------------------------------------------
-/files/en-us/mozilla/add-ons/    @mdn/yari-content-mozilla-add-ons
+# MathML
+/files/en-us/web/mathml/ @mdn/content-mathml
 
-# ----------------------------------------------------------------------------
-# ENGLISH MATHML CONTENT OWNER(S)
-# ----------------------------------------------------------------------------
-/files/en-us/web/mathml/    @mdn/content-mathml
+# ============================= CONTROL FILES ============================= #
+# The CODEOWNERS file must end with these matches: Any pull request changing
+# one or more of these files should be escalated to the owners specified here.
 
+# mdn/content GitHub configuration
+/.github/ @mdn/core-dev
+# Issue templates in .github
+/.github/ISSUE_TEMPLATE/ff-project-issue.md @mdn/core-yari-content
+
+# Root directory
+/* @mdn/core-dev
+# Markdown files in root directory
+/*.md @mdn/core-yari-content
 
-# ----------------------------------------------------------------------------
-# CONTROL FILES OWNER(S)
-# ----------------------------------------------------------------------------
-# These should be the last matches in this file, since any pull request that
-# tries to change any one or more of these files should be escalated to the
-# owners specified here.
-# ----------------------------------------------------------------------------
-/.github/     @mdn/core-dev
-/*            @mdn/core-dev
-/*.md         @mdn/core-yari-content
 # These are @mdn-bot because the auto-merge GHA workflow uses the PAT of this account.
 # If another reviewer is specified, update the PAT token or auto-merge will cease to be automatic.
 /package.json @mdn-bot
-/yarn.lock    @mdn-bot
+/yarn.lock @mdn-bot

.github/ISSUE_TEMPLATE/ff-project-issue.md

@@ -6,7 +6,7 @@ assignees:
 title: ""
 ---
 
-## Acceptance Criteria
+## Acceptance criteria
 
 - [ ] The listed features are documented sufficiently on MDN
 - [ ] BCD is updated
@@ -16,8 +16,8 @@ title: ""
 ### For folks helping with Firefox related documentation
 
 - [ ] Set bugs to `dev-doc-complete`
-- [ ] Add entry to Firefox release notes if feature is enabled in release
-- [ ] Add entry to Firefox experimental features page if feature is not yet enabled in release
+- [ ] Add entry to Firefox release notes for enabled/preview features
+- [ ] Add/remove entry to Firefox experimental features page for preference/released features
 
 ## Features to document
 
@@ -26,5 +26,3 @@ title: ""
 ## Other
 
 - [ ] Check content open issues to see if any pertain to the subject matter. If there are any that can be closed because of the work, do so. If there are any that can be fixed relatively quickly because of the knowledge from completing this issue and you have time, feel free to go ahead and fix them.
-- [ ] Check if glossary updates are required for the feature you're documenting - whether an existing term needs to be updated or a new term should be added.
-- [ ] Check if BCD update means that content pages need to have experimental markup removed or deprecated markup added (front matter tags and macros).