Guides & Deep Dives
Understand the compiler model behind Netsuke, learn where the sharp edges are, and use the same language the manifests use.
How Netsuke Works
Explore the six-stage pipeline that turns a YAML manifest into a static Ninja plan. The dynamic work happens up front, so execution stays fast and legible.
Manifest Parsing
YAML validation and raw manifest loading
Graph Analysis
Dependency resolution and cycle detection
Action Execution
Generated Ninja execution with clear diagnostics
Philosophy & Context
Forthcoming Capabilities
- System Facts Preview targeted at v0.1.1
- Standard Library Expansion Preview targeted at v0.1.x
- Structured Commands Preview targeted at v0.2.0
- Reusable Modules Preview targeted at v0.2.0
- Netsukefile Testing Framework Preview targeted at v0.3.0
- Netsukefile Linter Preview targeted at v0.4.0
- Property Testing Proposed · no release named
- States and Probes Proposed · no release named
- Typed Inputs Proposed · no release named
- Owned Artefacts Proposed · no release named
Contributing
Contribution Guidelines
Start here. Code of conduct, setting up your dev environment, and pull request etiquette.
Translating Netsuke
Full localization guide: Fluent files, message keys, plurals, the style guide and glossary, and adding a new locale.
Writing Examples & Showcases
Full guide to contributing example manifests and turning them into showcase pages.