Skip to content

Conversation

@dipikabh
Copy link
Contributor

@dipikabh dipikabh commented Dec 12, 2025

Description

This PR updates the Firefox release note template (follow-up to #42319 (comment)) and a few previous release note files.

  1. In the template file:
    - Added instruction to delete "Removals" if the section is empty.
    - Added section-specific deletion instruction, "Delete entire [section] section if no updates", because we remove the parent section for HTTP, SVG, MathML, Security, etc if they're empty. (It'll be good to have this info in the template rather than having to check our convention every time.)

    • Added "No notable changes." to "Changes for add-on developers" as well since we always keep this section. (We use this label for the core sections for HTML, CSS, and JavaScript that we don't delete.)
    • Reordered sections to follow this sequence:
      • Developer Tools
      • HTML
      • CSS
      • JavaScript
      • HTTP
      • SVG
      • MathML
      • Security
      • APIs
      • WebAssembly
      • WebDriver
  2. In the latest released (146), beta (147), and nightly (148) files, made updates to reflect changes in the template.

  3. In the remaining files:

    • Updated casing in "## Changes for Web developers" to "## Changes for web developers"
    • Updated the placement of the "Developer Tools" section to the top (when present)
    • Removed "Developer Tools" section where it was empty (123)

Motivation

Ordering the technologies/areas in the logical progression, starting with Dev Tools, then core technologies, followed by others

/cc @pepelsbey

@dipikabh dipikabh requested a review from a team as a code owner December 12, 2025 17:55
@dipikabh dipikabh requested review from pepelsbey and removed request for a team December 12, 2025 17:55
@github-actions github-actions bot added Content:Firefox Content in the Mozilla/Firefox subtree system [PR only] Infrastructure and configuration for the project size/m [PR only] 51-500 LoC changed labels Dec 12, 2025
@github-actions
Copy link
Contributor

github-actions bot commented Dec 12, 2025

Preview URLs (56 pages)
Flaws (4)

Note! 54 documents with no flaws that don't need to be listed. 🎉

URL: /en-US/docs/Mozilla/Firefox/Releases/42
Title: Firefox 42 release notes for developers
Flaw count: 2

  • macros:
    • Macro domxref produces link /en-US/docs/Web/API/Directory which doesn't resolve
    • Macro domxref produces link /en-US/docs/Web/API/Directory/path which doesn't resolve

URL: /en-US/docs/Mozilla/Firefox/Releases/44
Title: Firefox 44 release notes for developers
Flaw count: 2

  • macros:
    • Macro cssxref produces link /en-US/docs/Web/CSS/@page/marks which doesn't resolve
    • Macro domxref produces link /en-US/docs/Web/API/MessageEvent/initMessageEvent which doesn't resolve
External URLs (53)

URL: /en-US/docs/Mozilla/Firefox/Releases/9
Title: Firefox 9 release notes for developers


URL: /en-US/docs/Mozilla/Firefox/Releases/23
Title: Firefox 23 release notes for developers


URL: /en-US/docs/Mozilla/Firefox/Releases/24
Title: Firefox 24 release notes for developers


URL: /en-US/docs/Mozilla/Firefox/Releases/51
Title: Firefox 51 release notes for developers


URL: /en-US/docs/Mozilla/Firefox/Releases/89
Title: Firefox 89 release notes for developers


URL: /en-US/docs/Mozilla/Firefox/Releases/116
Title: Firefox 116 release notes for developers


URL: /en-US/docs/Mozilla/Firefox/Releases/123
Title: Firefox 123 release notes for developers


URL: /en-US/docs/Mozilla/Firefox/Releases/146
Title: Firefox 146 release notes for developers (Stable)

(comment last updated: 2025-12-15 14:53:25)

@dipikabh dipikabh changed the title fix(release-firefox): Reorder sections and add more instruction comments fix(release-firefox): Reorder sections Dec 15, 2025
@dipikabh
Copy link
Contributor Author

@pepelsbey I've removed the comments as discussed (they're not needed because the script automatically handles empty sections).

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Content:Firefox Content in the Mozilla/Firefox subtree size/m [PR only] 51-500 LoC changed system [PR only] Infrastructure and configuration for the project

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant