References
This page records durable external sources that inform the guidance in this repo.
Source Families
- Rust API Guidelines. Rust API shape, traits, errors, features, and docs.
- Microsoft Pragmatic Rust Guidelines. Agent-facing Rust defaults and safety guidance.
- Ed Page Rust Style. Rust module layout, imports, naming, and style.
- Ed Page PR Style. PR narrative and reviewer-oriented communication.
- The Rust Book and official Rust docs. Language behavior, ownership, traits, and cargo.
- Cargo Book. Cargo metadata, features, packaging, and dependency behavior.
- rustdoc docs. Rustdoc, doctests, and docs.rs-style builds.
- Jujutsu docs. jj commands, revsets, bookmarks, remotes, and recovery.
- Diataxis. Documentation type distinctions.
- tropes.md. AI writing tropes and generated-prose tells to watch for during prose review.
- OpenTelemetry. Logs, traces, metrics, and observability concepts.
- OWASP Cheat Sheets. Secret handling, logging safety, and security review.
- Martin Fowler and Refactoring. Refactoring, change shape, and design vocabulary.
- Parse, don't validate. Boundary correctness and typed validation.
- OpenAI docs. Agent and model behavior where product-specific.