Replace Jekyll docs with Nuxt Content, DocFX API, and Pages Actions - #40
Merged
Conversation
… and GitHub Pages Actions. Ship guides as Nuxt Content, generate API reference from pinned NuGet packages at build time, and deploy to autofixture.com on every merge to master.
Use unzip for .nupkg (ZIP) archives because GNU tar on Ubuntu cannot extract them; keep tar as a fallback for other platforms.
DocFX emits PascalCase .md files while routes and loaders use lowercase slugs; that only worked on case-insensitive disks. Sync to lowercase names and resolve files case-insensitively as a fallback.
Drop the unused Content collection stub, empty /docs index page, and unused public SVGs/ICO; clear the legacy content/api ignore and make clean remove that folder.
Update checkout, setup-node, setup-dotnet, cache, and Pages deploy actions so CI stops relying on deprecated Node 20 action runtimes.
Point the prerendered docs link at SpecimenFactory instead of the non-existent specimenfactory-1 slug.
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
1 participant
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.
Summary
site/, plus DocFX-based API generation from pinned NuGet packages (api-gen/).master→ GitHub Pages), with a deployment runbook.autofixture.com(root andsite/publicCNAME).Test plan
prepareAPI +nuxt generate)autofixture.com)/docs/...and a few/api/...deep linksCNAMEin the deployed artifact isautofixture.com