chore(ia): Tidy MDN meta dir

[bsmth]

Description

Notable: pages worth checking prose:

• files/en-us/mdn/index.md
• files/en-us/mdn/community/index.md
• files/en-us/mdn/community/open_source_etiquette/index.md
• files/en-us/mdn/community/our_repositories/index.md

Changes:

• sidebars are formatted using rari content fmt-sidebars
• short-titles in writing guidelines how-tos
• non-files/en-us/mdn/ changes update cross-references to moved files
• MDN/Changelog -> MDN/Writing_guidelines/Changelog

Removals:

• PAB & At_ten content removed in favor of the About page

Motivation

Docs IA & maintenance

[github-actions]

Preview URLs (77 pages)

• /en-US/docs/Learn_web_development/Howto/Design_and_accessibility/Common_web_layouts
• /en-US/docs/Learn_web_development/Howto/Design_and_accessibility/Design_for_all_types_of_users
• /en-US/docs/Learn_web_development/Howto/Design_and_accessibility/Thinking_before_coding
• /en-US/docs/Learn_web_development/Howto/Design_and_accessibility/What_is_accessibility
• /en-US/docs/Learn_web_development/Howto/Tools_and_setup/Checking_that_your_web_site_is_working_properly
• /en-US/docs/Learn_web_development/Howto/Tools_and_setup/What_software_do_I_need
• /en-US/docs/Learn_web_development
• /en-US/docs/MDN/Community/Communication_channels
• /en-US/docs/MDN/Community/Discussions/Managing_and_resolving_discussions
• /en-US/docs/MDN/Community/Discussions
• /en-US/docs/MDN/Community/Getting_started
• /en-US/docs/MDN/Community/Issues/Content_suggestions_feature_proposals
• /en-US/docs/MDN/Community/Issues
• /en-US/docs/MDN/Community/Learn_forum
• /en-US/docs/MDN/Community/Open_source_etiquette
• /en-US/docs/MDN/Community/Our_repositories
• /en-US/docs/MDN/Community/Pull_requests
• /en-US/docs/MDN/Community/Roles_teams
• /en-US/docs/MDN/Community/Security_vulnerability_response
• /en-US/docs/MDN/Community/Translated_content
• /en-US/docs/MDN/Community
• /en-US/docs/MDN/Writing_guidelines/Attrib_copyright_license
• /en-US/docs/MDN/Writing_guidelines/Changelog
• /en-US/docs/MDN/Writing_guidelines/Experimental_deprecated_obsolete
• /en-US/docs/MDN/Writing_guidelines/Howto/Creating_moving_deleting
• /en-US/docs/MDN/Writing_guidelines/Howto/Document_a_CSS_property
• /en-US/docs/MDN/Writing_guidelines/Howto/Document_an_HTTP_header
• /en-US/docs/MDN/Writing_guidelines/Howto/Document_web_errors
• /en-US/docs/MDN/Writing_guidelines/Howto/Images_media
• /en-US/docs/MDN/Writing_guidelines/Howto/JSON_Structured_data
• /en-US/docs/MDN/Writing_guidelines/Howto/Markdown_in_MDN
• /en-US/docs/MDN/Writing_guidelines/Howto/Research_technology
• /en-US/docs/MDN/Writing_guidelines/Howto/Write_a_new_entry_in_the_glossary
• /en-US/docs/MDN/Writing_guidelines/Howto/Write_an_api_reference/Information_contained_in_a_WebIDL_file
• /en-US/docs/MDN/Writing_guidelines/Howto/Write_an_api_reference/Sidebars
• /en-US/docs/MDN/Writing_guidelines/Howto/Write_an_api_reference
• /en-US/docs/MDN/Writing_guidelines/Howto
• /en-US/docs/MDN/Writing_guidelines/Page_structures/Banners_and_notices
• /en-US/docs/MDN/Writing_guidelines/Page_structures/Code_examples
• /en-US/docs/MDN/Writing_guidelines/Page_structures/Compatibility_tables
• /en-US/docs/MDN/Writing_guidelines/Page_structures/Feature_status
• /en-US/docs/MDN/Writing_guidelines/Page_structures/Links
• /en-US/docs/MDN/Writing_guidelines/Page_structures/Live_samples
• /en-US/docs/MDN/Writing_guidelines/Page_structures/Macros/Commonly_used_macros
• /en-US/docs/MDN/Writing_guidelines/Page_structures/Macros/Other
• /en-US/docs/MDN/Writing_guidelines/Page_structures/Macros
• /en-US/docs/MDN/Writing_guidelines/Page_structures/Page_types/API_constructor_subpage_template
• /en-US/docs/MDN/Writing_guidelines/Page_structures/Page_types/API_event_subpage_template
• /en-US/docs/MDN/Writing_guidelines/Page_structures/Page_types/API_landing_page_template
• /en-US/docs/MDN/Writing_guidelines/Page_structures/Page_types/API_method_subpage_template
• /en-US/docs/MDN/Writing_guidelines/Page_structures/Page_types/API_property_subpage_template
• /en-US/docs/MDN/Writing_guidelines/Page_structures/Page_types/API_reference_page_template
• /en-US/docs/MDN/Writing_guidelines/Page_structures/Page_types/ARIA_Page_Template
• /en-US/docs/MDN/Writing_guidelines/Page_structures/Page_types/CSS_function_page_template
• /en-US/docs/MDN/Writing_guidelines/Page_structures/Page_types/CSS_module_landing_page_template
• /en-US/docs/MDN/Writing_guidelines/Page_structures/Page_types/CSS_property_page_template
• /en-US/docs/MDN/Writing_guidelines/Page_structures/Page_types/CSS_selector_page_template
• /en-US/docs/MDN/Writing_guidelines/Page_structures/Page_types/Glossary_page_template
• /en-US/docs/MDN/Writing_guidelines/Page_structures/Page_types/HTML_element_page_template
• /en-US/docs/MDN/Writing_guidelines/Page_structures/Page_types/HTTP_header_page_template
• /en-US/docs/MDN/Writing_guidelines/Page_structures/Page_types/Page_type_key
• /en-US/docs/MDN/Writing_guidelines/Page_structures/Page_types/SVG_element_page_template
• /en-US/docs/MDN/Writing_guidelines/Page_structures/Page_types
• /en-US/docs/MDN/Writing_guidelines/Page_structures/Sidebars
• /en-US/docs/MDN/Writing_guidelines/Page_structures/Specification_tables
• /en-US/docs/MDN/Writing_guidelines/Page_structures/Syntax_sections
• /en-US/docs/MDN/Writing_guidelines/Page_structures
• /en-US/docs/MDN/Writing_guidelines/What_we_write/Criteria_for_inclusion
• /en-US/docs/MDN/Writing_guidelines/What_we_write
• /en-US/docs/MDN/Writing_guidelines/Writing_style_guide/Code_style_guide/CSS
• /en-US/docs/MDN/Writing_guidelines/Writing_style_guide/Code_style_guide/HTML
• /en-US/docs/MDN/Writing_guidelines/Writing_style_guide/Code_style_guide/JavaScript
• /en-US/docs/MDN/Writing_guidelines/Writing_style_guide/Code_style_guide/Shell
• /en-US/docs/MDN/Writing_guidelines/Writing_style_guide/Code_style_guide
• /en-US/docs/MDN/Writing_guidelines/Writing_style_guide
• /en-US/docs/MDN/Writing_guidelines
• /en-US/docs/MDN

Flaws (5)

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

URL: /en-US/docs/MDN
Title: MDN Web Docs
Flaw count: 2

• broken_links:
  • Can't resolve /en-US/about
• unknown:
  • No generic content config found

---

URL: /en-US/docs/MDN/Writing_guidelines/Page_structures/Page_types/API_reference_page_template
Title: API reference page template
Flaw count: 1

• unknown:
  • Invalid slug for templ/sidebar: MDN/Writing_guidelines/Page_structures/Page_types/API_reference_page_template

---

URL: /en-US/docs/MDN/Writing_guidelines/Page_structures/Sidebars
Title: Sidebars
Flaw count: 2

• broken_links:
  • https://developer.mozilla.org/en-US/docs/MDN/Changelog is a redirect
  • https://developer.mozilla.org/en-US/docs/Web/HTML is a redirect

External URLs (14)

URL: /en-US/docs/MDN/Community/Roles_teams
Title: MDN Web Docs roles and teams

• https://github.com/mdn (3 times) (Note! This may be a new URL 👀)
• https://github.com/orgs/mdn/people (2 times) (Note! This may be a new URL 👀)

---

URL: /en-US/docs/MDN/Community/Open_source_etiquette
Title: Open source etiquette

• https://google.github.io/eng-practices/ (1 time) (Note! This may be a new URL 👀)
• https://www.mozilla.org/en-US/about/governance/policies/participation/ (1 time) (Note! This may be a new URL 👀)

---

URL: /en-US/docs/MDN/Community/Getting_started
Title: Getting started with MDN Web Docs

• https://creativecommons.org/licenses/by-sa/4.0/ (1 time) (Note! This may be a new URL 👀)
• https://creativecommons.org/public-domain/cc0/ (1 time) (Note! This may be a new URL 👀)
• https://docs.github.com/en/get-started/getting-started-with-git/set-up-git (1 time) (Note! This may be a new URL 👀)
• https://docs.github.com/en/get-started/using-github/github-flow (1 time) (Note! This may be a new URL 👀)
• https://docs.github.com/en/pull-requests/collaborating-with-pull-requests (1 time) (Note! This may be a new URL 👀)
• https://github.com/orgs/mdn/projects/25/views/1 (3 times) (Note! This may be a new URL 👀)
• https://github.com/signup (1 time) (Note! This may be a new URL 👀)
• https://github.com/skills/communicate-using-markdown (1 time) (Note! This may be a new URL 👀)
• https://github.com/skills/introduction-to-github (1 time) (Note! This may be a new URL 👀)

---

URL: /en-US/docs/MDN/Community/Pull_requests
Title: Pull request submission and reviews

• https://google.github.io/eng-practices/review/reviewer/ (1 time) (Note! This may be a new URL 👀)

(comment last updated: 2025-01-31 16:19:14)

[hamishwillee]

IMO these are infrastructure, even if they are main repositories, they shoud be there because most consumers of this document need to know very little about them.

[hamishwillee]

What is "the web platform"? We use the term a lot, and I think we kind of have a somewhat clear definition of that that means. But it feels like a term that should be linked. Anyway, just rambling now, this is a huge PR to review.

[bsmth]

Good point, we should explain that.

this is a huge PR to review.

Sorry, and thank you! :)

[hamishwillee]

@bsmth I've finished looking. Can't guarantee the review was thorough, but I did look at all the pages. I always worry that as reviewer I'll be the last person that reads this kind of docs, but I guess we have to have it :-0

Anyway, these changes look sane, in particular the deletion of some of the cruft and the naming consistency work.

[bsmth]

@bsmth I've finished looking. Can't guarantee the review was thorough, but I did look at all the pages. I always worry that as reviewer I'll be the last person that reads this kind of docs, but I guess we have to have it :-0

Anyway, these changes look sane, in particular the deletion of some of the cruft and the naming consistency work.

Thank you very much 🙏🏻

[pepelsbey]

Looks good! Thanks :) Just a tiny nitpick.

[bsmth]

Thanks, all! Merging now!