Erin/astro switch#368
Merged
Merged
Conversation
erinxocon
force-pushed
the
erin/astro-switch
branch
6 times, most recently
from
909d733 to
6db293e
Compare
erinxocon
force-pushed
the
erin/astro-switch
branch
5 times, most recently
from
8532748 to
8887477
Compare
typescript, node24, and pnpm11 as our tech stack
(*) don't run under root and update remote user id so i don't have perms issues in parent file system (*) if image format is not specified, use avif for MAXIMUM POWER (*) add remark for marsing mdd into AST tree so we can dynamically create the sidebar
… script to convert the SUMMARY.md file to a sidebar js object starlight can underatand. (+) pass in the location of the summary file (+) add a script to convert all existing documents to mdx files with a proper frontmatter title so starlight can read it (*) move files to new location for astro content dir (*) simpler migration script
(*) remove, squash later
… so we can make it the main page (*) remove remark frontmatter
(*) move scripts
…ccessed original size image (*) package update (*) update astro config (*) we no longer need this file (*) move favicon to proper place (*) add unified for plugin type defitions (*) migrate plugin to a typescript file with proper signature for remark plugin type
… to overview since section title already includes the model number
…r for docs loader is dropping the period, so we override it with a static slug to keep it so links work (*) do not process svg's under sharp pipeline or wrap them in links since they go unoptimized
(*) let package.json specify the version of pnpm (*) use s3 cache which I've prepopulated (+) add prettier for ci steps to ensure things are formatted
… items look like labels that do have sub items (*) type the prettier config file to see proper options and option types (+) add blame ignore revs for huge format commits
(*) update with another format rev (*) update ci file for new workflow (*) remove staging (*) drop the box shadow, add padding and margins
(*) pnpm 11 is only available with node version 24
supply chain attacks (*) commit hases instead of tag numbers to avoid supply chain attack (*) use frozen lockfile so job fails if the lock file and package.json are out of sync
…ng job, with step to save build cache
(*) fix path (*) migrate new thelio docs to contain frontmatter with a title instead of a #tag
erinxocon
force-pushed
the
erin/astro-switch
branch
from
8887477 to
10612f3
Compare
jacobgkau
approved these changes
Jun 11, 2026
jacobgkau
left a comment
jacobgkau
left a comment
Member
There was a problem hiding this comment.
Staging has all of the tweaks we've been working on recently. Looks good to me.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Migrate docs site from mdbook to Astro Starlight
This PR replaces the mdbook setup with Astro Starlight, giving us a modern, actively maintained docs framework with better theming, sidebar control, and a dev container for local development.
Framework migration
book.tomlwithastro.config.mjs; addpackage.json,pnpm-lock.yaml,pnpm-workspace.yamlDev container
.devcontainer/Dockerfileanddevcontainer.jsonfor reproducible local devContent reorganization
src/content/docs/to match Astro's content collections structureREADME.mdfiles toindex.mdso it serves as a landing page, and rename sectionREADME.mdfiles tospecs.mdtitlefieldsCustom plugins & utilities
SUMMARY.mdinto a Starlight sidebar config, preserving existing structure without a full content rewrite<img>with a link to the original full-size fileavifImageService.mjs)Styling
toc-width-fix.css)img-background.css)src/assets/img/CI/CD
ci.yml,deploy-prod.yml, anddeploy-staging.ymlfor Astro build pipelineMisc
baseUrlsince the site is hosted at/tech-docs