Incan Contributor Book (Advanced, Rust-first)

This is a linear, Rust-first track for contributors working on the Incan compiler, tooling, and docsite.

This book is intentionally opinionated and may duplicate some material from the standalone contributing pages so it can be read end-to-end like a book.

Before you start (required)

• Architecture — compilation pipeline + module layout
• Extending the language — builtin vs new syntax decision + end-to-end checklists
• Layering rules — dependency boundaries and guardrails
• Readable, maintainable Rust — conventions and guardrails for changing the Rust codebase
• RFC index — required for new language features (syntax/semantics), not for bugs/chores

Chapters

Read in order:

1. 01. Architecture tour
2. 02. Layering and boundaries
3. 03. Proposals: issues vs RFCs
4. 04. Your first change: add a builtin
5. 05. Your first syntax change
6. 06. Tooling loop: formatter + tests
7. 07. Tooling loop: LSP
8. 08. Docsite contributor loop