fix(release-firefox): Reorder sections

[dipikabh]

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

[github-actions]

Preview URLs (56 pages)

• /en-US/docs/Mozilla/Firefox/Releases/10
• /en-US/docs/Mozilla/Firefox/Releases/116
• /en-US/docs/Mozilla/Firefox/Releases/11
• /en-US/docs/Mozilla/Firefox/Releases/123
• /en-US/docs/Mozilla/Firefox/Releases/12
• /en-US/docs/Mozilla/Firefox/Releases/13
• /en-US/docs/Mozilla/Firefox/Releases/146
• /en-US/docs/Mozilla/Firefox/Releases/147
• /en-US/docs/Mozilla/Firefox/Releases/148
• /en-US/docs/Mozilla/Firefox/Releases/14
• /en-US/docs/Mozilla/Firefox/Releases/15
• /en-US/docs/Mozilla/Firefox/Releases/16
• /en-US/docs/Mozilla/Firefox/Releases/17
• /en-US/docs/Mozilla/Firefox/Releases/18
• /en-US/docs/Mozilla/Firefox/Releases/19
• /en-US/docs/Mozilla/Firefox/Releases/20
• /en-US/docs/Mozilla/Firefox/Releases/21
• /en-US/docs/Mozilla/Firefox/Releases/22
• /en-US/docs/Mozilla/Firefox/Releases/23
• /en-US/docs/Mozilla/Firefox/Releases/24
• /en-US/docs/Mozilla/Firefox/Releases/25
• /en-US/docs/Mozilla/Firefox/Releases/26
• /en-US/docs/Mozilla/Firefox/Releases/27
• /en-US/docs/Mozilla/Firefox/Releases/28
• /en-US/docs/Mozilla/Firefox/Releases/29
• /en-US/docs/Mozilla/Firefox/Releases/30
• /en-US/docs/Mozilla/Firefox/Releases/31
• /en-US/docs/Mozilla/Firefox/Releases/32
• /en-US/docs/Mozilla/Firefox/Releases/33
• /en-US/docs/Mozilla/Firefox/Releases/34
• /en-US/docs/Mozilla/Firefox/Releases/35
• /en-US/docs/Mozilla/Firefox/Releases/36
• /en-US/docs/Mozilla/Firefox/Releases/37
• /en-US/docs/Mozilla/Firefox/Releases/38
• /en-US/docs/Mozilla/Firefox/Releases/39
• /en-US/docs/Mozilla/Firefox/Releases/40
• /en-US/docs/Mozilla/Firefox/Releases/41
• /en-US/docs/Mozilla/Firefox/Releases/42
• /en-US/docs/Mozilla/Firefox/Releases/43
• /en-US/docs/Mozilla/Firefox/Releases/44
• /en-US/docs/Mozilla/Firefox/Releases/45
• /en-US/docs/Mozilla/Firefox/Releases/46
• /en-US/docs/Mozilla/Firefox/Releases/47
• /en-US/docs/Mozilla/Firefox/Releases/48
• /en-US/docs/Mozilla/Firefox/Releases/49
• /en-US/docs/Mozilla/Firefox/Releases/50
• /en-US/docs/Mozilla/Firefox/Releases/51
• /en-US/docs/Mozilla/Firefox/Releases/52
• /en-US/docs/Mozilla/Firefox/Releases/53
• /en-US/docs/Mozilla/Firefox/Releases/54
• /en-US/docs/Mozilla/Firefox/Releases/55
• /en-US/docs/Mozilla/Firefox/Releases/56
• /en-US/docs/Mozilla/Firefox/Releases/57
• /en-US/docs/Mozilla/Firefox/Releases/58
• /en-US/docs/Mozilla/Firefox/Releases/89
• /en-US/docs/Mozilla/Firefox/Releases/9

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

• https://firefox-source-docs.mozilla.org/devtools-user/web_console/index.html (2 times) (Note! This may be a new URL 👀)

---

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

• https://bugzil.la/834836 (1 time) (Note! This may be a new URL 👀)

---

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

• https://bugzil.la/870361 (1 time) (Note! This may be a new URL 👀)
• https://mihai.sucan.ro/mihai/blog/the-browser-console-is-replacing-the-error-console/ (1 time) (Note! This may be a new URL 👀)

---

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

• https://bugzilla.mozilla.org/buglist.cgi?list_id=13263768&resolution=FIXED&classification=Client%20Software&chfieldto=2016-09-19&query_format=advanced&chfield=resolution&chfieldfrom=2016-08-01&chfieldvalue=FIXED&bug_status=RESOLVED&bug_status=VERIFIED&component=Developer%20Tools&component=Developer%20Tools%3A%20about%3Adebugging&component=Developer%20Tools%3A%20Animation%20Inspector&component=Developer%20Tools%3A%20Canvas%20Debugger&component=Developer%20Tools%3A%20Computed%20Styles%20Inspector&component=Developer%20Tools%3A%20Console&component=Developer%20Tools%3A%20CSS%20Rules%20Inspector&component=Developer%20Tools%3A%20Debugger&component=Developer%20Tools%3A%20DOM&component=Developer%20Tools%3A%20Font%20Inspector&component=Developer%20Tools%3A%20Framework&component=Developer%20Tools%3A%20Graphic%20Commandline%20and%20Toolbar&component=Developer%20Tools%3A%20Inspector&component=Developer%20Tools%3A%20JSON%20Viewer&component=Developer%20Tools%3A%20Memory&component=Developer%20Tools%3A%20Netmonitor&component=Developer%20Tools%3A%20Object%20Inspector&component=Developer%20Tools%3A%20Performance%20Tools%20%28Profiler%2FTimeline%29&component=Developer%20Tools%3A%20Responsive%20Design%20Mode&component=Developer%20Tools%3A%20Scratchpad&component=Developer%20Tools%3A%20Shared%20Components&component=Developer%20Tools%3A%20Source%20Editor&component=Developer%20Tools%3A%20Storage%20Inspector&component=Developer%20Tools%3A%20Style%20Editor&component=Developer%20Tools%3A%20User%20Stories&component=Developer%20Tools%3A%20Web%20Audio%20Editor&component=Developer%20Tools%3A%20WebGL%20Shader%20Editor&component=Developer%20Tools%3A%20WebIDE&product=Firefox (1 time) (Note! This may be a new URL 👀)
• https://firefox-source-docs.mozilla.org/devtools-user/network_monitor/index.html (1 time) (Note! This may be a new URL 👀)

---

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

• https://blog.mozilla.org/addons/2021/04/19/changes-to-themeable-areas-of-firefox-in-version-89/ (1 time)
• https://bugzil.la/1220696 (1 time)
• https://bugzil.la/1536094 (1 time)
• https://bugzil.la/1659511 (1 time)
• https://bugzil.la/1672073 (1 time)
• https://bugzil.la/1681046 (1 time)
• https://bugzil.la/1681691 (1 time)
• https://bugzil.la/1691454 (1 time)
• https://bugzil.la/1694679 (1 time)
• https://bugzil.la/1695404 (1 time)
• https://bugzil.la/1697630 (1 time)
• https://bugzil.la/1699707 (2 times)
• https://bugzil.la/1701029 (1 time)
• https://bugzil.la/1701824 (1 time)
• https://bugzil.la/1703505 (1 time)
• https://bugzil.la/1703537 (1 time)
• https://bugzil.la/1704474 (1 time)
• https://bugzil.la/1704494 (1 time)
• https://bugzil.la/1712556 (1 time)
• https://hacks.mozilla.org/2021/06/looking-fine-with-firefox-89/ (1 time)

---

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

• https://bugzil.la/1752760 (1 time) (Note! This may be a new URL 👀)
• https://bugzil.la/1789193 (1 time) (Note! This may be a new URL 👀)
• https://bugzil.la/1810195 (1 time) (Note! This may be a new URL 👀)
• https://bugzil.la/1816115 (1 time) (Note! This may be a new URL 👀)
• https://bugzil.la/1836755 (1 time) (Note! This may be a new URL 👀)
• https://firefox-source-docs.mozilla.org/devtools-user/custom_formatters/index.html (1 time) (Note! This may be a new URL 👀)

---

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

• https://bugzil.la/1333395 (1 time)
• https://bugzil.la/1730706 (2 times)
• https://bugzil.la/1790375 (1 time)
• https://bugzil.la/1855023 (1 time)
• https://bugzil.la/1866431 (1 time)
• https://bugzil.la/1869536 (1 time)
• https://bugzil.la/1870052 (1 time)
• https://bugzil.la/1870434 (1 time)
• https://bugzil.la/1870570 (1 time)
• https://bugzil.la/1870863 (1 time)
• https://bugzil.la/1872116 (1 time)
• https://bugzil.la/1872333 (1 time)
• https://bugzil.la/1872675 (1 time)
• https://bugzil.la/1873688 (1 time)
• https://bugzil.la/1874445 (2 times)
• https://bugzil.la/1875086 (1 time)
• https://w3c.github.io/webdriver-bidi/ (6 times)
• https://w3c.github.io/webdriver/ (1 time)
• https://whattrainisitnow.com/release/?version=123 (1 time)

---

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

• https://bugzil.la/1994171 (1 time) (Note! This may be a new URL 👀)
• https://bugzil.la/1994172 (1 time) (Note! This may be a new URL 👀)

(comment last updated: 2025-12-16 15:59:16)

[dipikabh]

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

[pepelsbey]

I see you reordered MathML and SVG, but it was on purpose to have them right after HTML, since they're also markup languages.

Also, there are still many "remove X if empty" comments left that we don't need, as the release script handles removals automatically.

So, the idea is:

1. All section headings are commented and will be removed automatically if empty, apart from HTML, CSS, and JavaScript.
2. Only HTML, CSS, and JavaScript sections have "no notable changes" comments that will be uncommented.

We don't need any other comments or changes to the template, apart from adding the DevTools section.

[github-actions]

This pull request has merge conflicts that must be resolved before it can be merged.

[dipikabh]

there are still many "remove X if empty" comments

Oops! I removed them from the template file but missed removing them from 147 and 148 relnote files. All gone now 👍

I see you reordered MathML and SVG, but it was on purpose to have them right after HTML, since they're also markup languages.

Yes, that makes logical sense and I gathered that would have been the reason.
The sequence HTML → CSS → JavaScript → HTTP → SVG/MathML → APIs makes more sense though because it prioritizes the core technologies more prominently at the top.

In fact, I applied the reordering because I assumed that was the sequence we've used historically.
So I checked what we've done in the past. Of all the relnotes that contain MathML or SVG sections (excluding 146 and 147):

• 7 place them immediately after HTML
• 54 place them after JavaScript or HTTP

(I just resolved some merge conflicts in 147 and I haven't updated the order in it yet, pending what we decide to do with the sequence.)

[pepelsbey]

7 place them immediately after HTML
54 place them after JavaScript or HTTP

There was a moment when I started doing this for logical grouping. That's why it doesn't go all the way back and there are only 7 in that order.

I would suggest keeping changes to a minimum, given the plans for this section, and focus on improving the template for the future releases.