Skip to content

docs: alphabetize Starlight sidebar groups and overview page lists - #83

Merged
LinKCoding merged 1 commit into
mainfrom
kl-gmt-1871-alphabetize-starlight-pages
Nov 20, 2026
Merged

LinKCoding merged 1 commit into
mainfrom
kl-gmt-1871-alphabetize-starlight-pages

Conversation

@LinKCoding

@LinKCoding LinKCoding commented Nov 13, 2026 •

Copy link
Copy Markdown
Contributor

Overview

Sorts the Starlight docs sidebar and the overview pages' link lists alphabetically, so readers can find pages without scanning an arbitrary order.

  • packages/gamut-docs/astro.config.mjs: reordered the Components topic groups to Overview, Actions, Containers, Data display, Feedback, Inputs & forms, Media & assets, Navigation, Overlays, Status, Typography, Utilities. Overview stays first.
  • Sorted the link lists on 24 overview pages under packages/gamut-docs/src/content/docs (Components, Guides, Foundations, Concepts, each Components category, and the nested Buttons, Boxes, Tips, Loaders, Icons, Animations, Form, ConnectedForm, List and Foundations tooling overviews).
  • Bullets that group several links (for example "Modal, Dialog, Overlay") stay together and sort by their first entry.
  • Left alone: autogenerated sections (Starlight already sorts them), the explicit Getting started order, the Components placement table, and non-page bullet lists.

PR Checklist

  • Related to designs:
  • Related to JIRA ticket: GMT-1871
  • Changeset added (or empty changeset if no release)
  • I have run this code to verify it works
  • This PR includes unit tests for the code change
  • This PR includes testing instructions tests for the code change
  • Package previews from this PR are passing end-to-end tests in all relevant consuming repositories

Testing Instructions

Don't make me tap the sign.

  1. Run the docs site locally (yarn start) and start up the starlight site localhost:3333
  2. Go through each group and confirm the sidebar groups read alphabetically (Overview should always be first though)
  3. Continue through each group, on the Overview page, the listed items should also be in alphabetical order (i.e. match the sidebar)
  4. ...
  5. Profit

PR Links and Envs

Repository PR Link
Monolith Monolith PR
Mono Mono PR

🤖 Generated with Claude Code

@pkg-pr-new

pkg-pr-new Bot commented Nov 13, 2026 •

Copy link
Copy Markdown

Open in StackBlitz

@skillsoft/eslint-plugin-gamut

npm i https://pkg.pr.new/Codecademy/skillsoft-gamut/@skillsoft/eslint-plugin-gamut@83
yarn add https://pkg.pr.new/Codecademy/skillsoft-gamut/@skillsoft/eslint-plugin-gamut@83.tgz

@skillsoft/gamut

npm i https://pkg.pr.new/Codecademy/skillsoft-gamut/@skillsoft/gamut@83
yarn add https://pkg.pr.new/Codecademy/skillsoft-gamut/@skillsoft/gamut@83.tgz

@skillsoft/gamut-agent-tools

npm i https://pkg.pr.new/Codecademy/skillsoft-gamut/@skillsoft/gamut-agent-tools@83
yarn add https://pkg.pr.new/Codecademy/skillsoft-gamut/@skillsoft/gamut-agent-tools@83.tgz

@skillsoft/gamut-codemods

npm i https://pkg.pr.new/Codecademy/skillsoft-gamut/@skillsoft/gamut-codemods@83
yarn add https://pkg.pr.new/Codecademy/skillsoft-gamut/@skillsoft/gamut-codemods@83.tgz

@skillsoft/gamut-icons

npm i https://pkg.pr.new/Codecademy/skillsoft-gamut/@skillsoft/gamut-icons@83
yarn add https://pkg.pr.new/Codecademy/skillsoft-gamut/@skillsoft/gamut-icons@83.tgz

@skillsoft/gamut-illustrations

npm i https://pkg.pr.new/Codecademy/skillsoft-gamut/@skillsoft/gamut-illustrations@83
yarn add https://pkg.pr.new/Codecademy/skillsoft-gamut/@skillsoft/gamut-illustrations@83.tgz

@skillsoft/gamut-patterns

npm i https://pkg.pr.new/Codecademy/skillsoft-gamut/@skillsoft/gamut-patterns@83
yarn add https://pkg.pr.new/Codecademy/skillsoft-gamut/@skillsoft/gamut-patterns@83.tgz

@skillsoft/gamut-styles

npm i https://pkg.pr.new/Codecademy/skillsoft-gamut/@skillsoft/gamut-styles@83
yarn add https://pkg.pr.new/Codecademy/skillsoft-gamut/@skillsoft/gamut-styles@83.tgz

@skillsoft/gamut-tests

npm i https://pkg.pr.new/Codecademy/skillsoft-gamut/@skillsoft/gamut-tests@83
yarn add https://pkg.pr.new/Codecademy/skillsoft-gamut/@skillsoft/gamut-tests@83.tgz

@skillsoft/variance

npm i https://pkg.pr.new/Codecademy/skillsoft-gamut/@skillsoft/variance@83
yarn add https://pkg.pr.new/Codecademy/skillsoft-gamut/@skillsoft/variance@83.tgz

commit: 32483d5

@codecov

codecov Bot commented Nov 13, 2026 •

Copy link
Copy Markdown

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 77.20%. Comparing base (ae05e8c) to head (32483d5).
✅ All tests successful. No failed tests found.

❌ Your project check has failed because the head coverage (77.20%) is below the target coverage (80.00%). You can increase the head coverage or adjust the target coverage.

Additional details and impacted files
@@           Coverage Diff           @@
##             main      #83   +/-   ##
=======================================
  Coverage   77.20%   77.20%           
=======================================
  Files         464      464           
  Lines       32091    32091           
  Branches     1535     1441   -94     
=======================================
  Hits        24776    24776           
- Misses       7307     7315    +8     
+ Partials        8        0    -8     
Flag Coverage Δ
main ?
pull-request 77.20% <ø> (?)

Flags with carried forward coverage won't be shown. Click here to find out more.

☔ View full report in Codecov by Harness.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:
  • 📦 JS Bundle Analysis: Save yourself from yourself by tracking and limiting bundle sizes in JS merges.

@LinKCoding
LinKCoding marked this pull request as ready for review November 13, 2026 20:12
@LinKCoding
LinKCoding requested a review from a team as a code owner November 13, 2026 20:12
Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
@LinKCoding
LinKCoding force-pushed the kl-gmt-1871-alphabetize-starlight-pages branch from 2628af3 to 32483d5 Compare November 20, 2026 21:48
@LinKCoding
LinKCoding merged commit bd0f823 into main Nov 20, 2026
14 of 15 checks passed
@LinKCoding
LinKCoding deleted the kl-gmt-1871-alphabetize-starlight-pages branch November 20, 2026 21:58
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants