Add VitePress documentation site for JasperFx#175
Merged
jeremydmiller merged 2 commits intomainfrom Apr 2, 2026
Merged
Conversation
- VitePress site in docs/ with orange JasperFx-branded theme - 21 documentation pages across 5 sections: Getting Started, Code Generation, Command Line, Configuration, Extension Methods - Code Generation section with Mermaid architecture diagram, detailed Frame/Variable/MethodCall/GeneratedType reference pages - Command Line section covering setup, writing commands, arguments/flags, environment checks, and describe command - CritterStackDefaults and JasperFxOptions configuration docs - Extension method reference for String, Enumerable, and Reflection helpers - All code samples in compilable DocSamples project using mdsnippets - Netlify deployment config targeting docs.jasperfx.net - Root package.json with mdsnippets + concurrently for docs workflow Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Builds DocSamples, runs mdsnippets, builds VitePress, and deploys to Netlify. Triggers on pushes to main that touch docs/, src/DocSamples/, or mdsnippets.json. Also supports manual workflow_dispatch. Requires NETLIFY_AUTH_TOKEN and NETLIFY_SITE_ID secrets. Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
This was referenced Apr 23, 2026
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
DocSamplesproject usingmdsnippets(same pattern as Marten and Weasel)Site sections
Infrastructure
docs/— VitePress site with custom orange themesrc/DocSamples/— Compilable C# project with all code samplesmdsnippets.json— Snippet extraction config (scans both DocSamples and source projects)package.json— Root-level npm scripts (npm run docs,npm run docs-build)netlify.toml— Deployment configTest plan
dotnet build src/DocSamplescompiles with 0 errorsmdsnippetsinjects all snippets into markdownnpx vitepress build docsbuilds with 0 errors (22 HTML pages)🤖 Generated with Claude Code