Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

chore(ia): Tidy MDN meta dir #37784

Open
wants to merge 19 commits into
base: main
Choose a base branch
from
Open

chore(ia): Tidy MDN meta dir #37784

wants to merge 19 commits into from

Conversation

bsmth
Copy link
Member

@bsmth bsmth commented Jan 24, 2025

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

@bsmth bsmth requested review from a team as code owners January 24, 2025 09:45
@bsmth bsmth requested review from hamishwillee and removed request for a team January 24, 2025 09:45
@github-actions github-actions bot added Content:Meta Content in the meta docs size/xl [PR only] >1000 LoC changed labels Jan 24, 2025
Copy link
Contributor

github-actions bot commented Jan 24, 2025

Preview URLs (35 pages)
Flaws (3)

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

URL: /en-US/docs/MDN/Community/Discussions
Title: GitHub Discussions
Flaw count: 1

  • unknown:
    • No generic content root set

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

  • broken_links:
    • no explanation!
    • no explanation!
External URLs (15)

URL: /en-US/docs/MDN/Community
Title: Community resources


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


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


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


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

(comment last updated: 2025-01-24 10:29:10)

Comment on lines 5958 to 5963
/en-US/docs/MDN/MDN_Product_Advisory_Board https://github.com/mdn/pab/blob/main/about.md
/en-US/docs/MDN/MDN_Product_Advisory_Board/Members https://github.com/mdn/pab/blob/main/about.md
/en-US/docs/MDN/MDN_Product_Advisory_Board/Membership https://github.com/mdn/pab/blob/main/membership.md
/en-US/docs/MDN/MDN_Product_Avisory_Board https://github.com/mdn/pab/blob/main/about.md
/en-US/docs/MDN/MDN_Product_Avisory_Board/Members https://github.com/mdn/pab/blob/main/about.md
/en-US/docs/MDN/MDN_Product_Avisory_Board/Membership https://github.com/mdn/pab/blob/main/membership.md
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

How about redirecting to https://developer.mozilla.org/en-US/about#our_partners instead?

Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thanks for checking, let me double check (ignore the re-request for review for now)

Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Tools don't like /about, using https://developer.mozilla.org/en-US/about#our_journey instead, see 092697f

@bsmth bsmth requested a review from caugner January 24, 2025 09:58
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
Content:Meta Content in the meta docs size/xl [PR only] >1000 LoC changed
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants