Concepts & Contribution
Guides & Deep Dives
Understand the compiler model behind Netsuke, learn where the sharp edges are, and use the same language the manifests use.
Architecture
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.
1
Manifest Parsing
YAML validation and raw manifest loading
2
Graph Analysis
Dependency resolution and cycle detection
3
Action Execution
Generated Ninja execution with clear diagnostics
pipeline_state.rs
fn construct_graph(manifest) -> Graph {
... internal logic ...
Analysis Phase
Execution Phase
}
Input: 14kb
Output: Binary
Philosophy & Context
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, and adding a new locale.
Writing Examples & Showcases
Full guide to contributing example manifests and turning them into showcase pages.