astrid-runtime/handbook
Handbook
This repository is the contributor handbook for the Astrid runtime, a runtime split across many separate repositories. It explains how to contribute: where each piece of code lives, how the parts fit together, and which rules govern changes. The handbook is written as source files and compiled into a searchable, browsable online book.
The guidance covers the project's contribution governance. Contributors choose a contribution tier that matches the scope of their change, and they sign their commits. Core pull requests are linked to closed issues, and contributors review their own changes adversarially before asking for review, with extra scrutiny on security-critical code. Changes to the public contract between the core and user-facing code (binary interfaces, message schemas and permissions) go through a written RFC process before any implementation begins. Each version bump ships in its own pull request, separate from feature or fix changes.
The handbook also describes the design principles behind the runtime. The kernel is kept minimal and limited to event routing, capability enforcement and sandbox execution. All other logic lives in separate components that talk to the kernel only through messages. Components run sandboxed and are granted only the capabilities they have been explicitly permitted.
The documentation is built with a static site generator and can be served locally for previewing changes. The implementation is treated as the source of truth, so any documentation that disagrees with the source code is considered a bug. The work is licensed under Apache, with both copyright and patent grants.
