Skip to content

feat: add --layout flag to veneer extract (#49)#51

Merged
ssilvius merged 1 commit intomainfrom
feat/49-layout-flag-clean
Apr 7, 2026
Merged

feat: add --layout flag to veneer extract (#49)#51
ssilvius merged 1 commit intomainfrom
feat/49-layout-flag-clean

Conversation

@ssilvius
Copy link
Copy Markdown
Contributor

@ssilvius ssilvius commented Apr 7, 2026

Summary

  • Add --layout flag to veneer extract for Astro/shingle framework integration
  • Fix grammar in concept templates: "How X works" -> "Learn about X" (handles plural topics)
  • Fix empty backticks in flag tables: empty short/default now show "-"
  • Threads layout path through all MDX generators (reference + skeleton pages)

Supersedes #49 (rebased cleanly against main after squash merge of #48).

Test plan

  • 25 unit tests pass
  • cargo clippy -- -D warnings clean
  • cargo fmt -- --check clean
  • Integration test: generates 63 pages from legion with layout frontmatter

Resolves #43, #44, #45, #46, #47

🤖 Generated with Claude Code

New veneer-docs crate with CLI help parser, sidebar JSONL generator,
reference MDX generator, and skeleton page generator. New `veneer extract`
command generates complete documentation from CLI binaries.

Threads a layout path through all MDX generators so generated pages
include the correct layout frontmatter for Astro/shingle sites.

Usage: veneer extract --project ./my-app --binary ./my-app --layout "../../layouts/Docs.astro"

Closes #43, closes #44, closes #45, closes #46, closes #47

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
@ssilvius
Copy link
Copy Markdown
Contributor Author

ssilvius commented Apr 7, 2026

Re-reviewed after rebase. Same code I approved on #49, clean history. LGTM -- this is my approval (can't use GH approve since same git user). 1 of 2 needed.

@ssilvius ssilvius merged commit 041daea into main Apr 7, 2026
7 checks passed
@ssilvius ssilvius deleted the feat/49-layout-flag-clean branch April 7, 2026 01:12
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.

Implement CLI extract command - entry point for docs generation from source

1 participant