Commit cac4a8b
committed
docs: add comprehensive Stardoc API documentation and cleanup internal docs
Add auto-generated API documentation for all rule files using Stardoc with
Astro frontmatter integration. Clean up 42 internal status/progress markdown
files to keep documentation focused and professional.
API Documentation (10 rule categories, 142K total):
- Create Stardoc targets for cpp, rust, go, js, wit, wasm, wkg, wac, wrpc rules
- Add Astro frontmatter to all generated docs using pure Bazel genrule
- Deploy generated docs to docs-site/src/content/docs/api/
- Total: 10 comprehensive API reference files auto-generated from source
Build System Improvements:
- Add missing bzl_library targets (wit_markdown, wac_bundle, wac_plug, etc.)
- Add proper dependencies to all Stardoc targets
- Create comprehensive docs/BUILD.bazel with organized sections
Docstring Fixes (Stardoc compatibility):
- Fix wkg/defs.bzl: wasm_component_oci_publish docstring format
- Fix rust/rust_wasm_component_bindgen.bzl: simplify multi-paragraph description
- Fix rust/rust_wasm_component_wizer.bzl: consolidate description
- Fix rust/rust_wasm_binary.bzl: simplify description
Documentation Cleanup (removed 42 files):
- Delete root-level status docs (ACHIEVEMENTS.md, HERMITICITY.md, etc.)
- Delete internal planning docs (DOCUMENTATION_PLAN.md, INTEGRATION_PLAN.md, etc.)
- Delete duplicate documentation (docs/examples/ directory)
- Delete Claude skill docs and internal tool notes
- Keep only user/developer-facing documentation
Result:
- Clean, professional documentation structure (94 → 52 files)
- Comprehensive auto-generated API reference
- Pure Bazel implementation (no shell scripts for doc generation)
- Ready for Astro/Starlight docs site integration1 parent 52ec602 commit cac4a8b
File tree
61 files changed
+4926
-8540
lines changed- docs-site
- src/content/docs/api
- docs
- examples
- advanced
- basic
- intermediate
- templates
- examples
- basic
- go_component
- microservices_architecture
- wasmtime_runtime
- wit_bindgen_with_mappings
- rust
- toolchains
- tools-builder
- tools
- checksum_validator_multi
- hermetic_test
- wac
- wasm
- wit
- wkg
Some content is hidden
Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.
61 files changed
+4926
-8540
lines changedThis file was deleted.
This file was deleted.
0 commit comments