microsoft/RustTraining
53.4
Weak · 14 November 2026
448
lines of production code
Rust
with JavaScript
5
measurements over time
What this system is
This system is a static documentation platform built with Rust and mdBook, designed to host and serve a collection of technical training books. It provides tooling to build, preview, and deploy these sites to GitHub Pages or self-host them via Docker. The platform supports interactive features like Mermaid diagrams and code playgrounds across multiple language-specific guides, including Rust and C\#.
Features
Add Async Rust training book with Mermaid diagram support
The repository now includes a new static site for the 'Async Rust: From Futures to Production' training material, built using mdBook. This addition enables interactive Mermaid diagrams within the documentation by bundling the \mermaid.min.js\ library and a custom \mermaid-init.js\ script that handles theme switching (light/dark mode) and re-rendering. The book is configured to use a light default theme with 'ayu' as the preferred dark theme, and includes editable code playgrounds with line numbers.
(repo-wide) · high confidence
Add C\# to Rust training book with Mermaid diagram support
Introduces a new 'Rust for C\# Programmers' training book in the csharp-book directory, providing a structured guide for C\# developers learning Rust. The content includes source documents (RustBootstrapForCSharp.md, RustTrainingForCSharp.md) and a merged chapter plan (MERGE\_PLAN.md) covering topics from basic types to memory management and migration patterns. The book configuration (book.toml) enables Mermaid diagram rendering via an optional mdbook-mermaid preprocessor, supported by custom JavaScript files (mermaid-init.js, mermaid.min.js) for theme-aware diagram rendering.
csharp-book · high confidence
Add Mermaid diagram support with theme-aware rendering
The Type-Driven Correctness in Rust book now supports Mermaid diagrams. This change adds the \mdbook-mermaid\ preprocessor configuration and includes the necessary JavaScript libraries (\mermaid.min.js\ and \mermaid-init.js\) to render diagrams. The initialization script ensures diagrams correctly adapt to the user's selected theme (light or dark) by reloading the page when the theme is switched.
type-driven-correctness-book · high confidence
Add optional Docker deployment for self-hosting
Users can now self-host the book collection using Docker, providing an alternative to GitHub Pages for internal networks or firewalled environments. The change introduces a multi-stage Dockerfile that builds the static site using mdbook and mdbook-mermaid, then serves it via an unprivileged nginx container on port 8080. A Docker Compose file is included to simplify local development and deployment, allowing users to start the service with a single command while ensuring the container runs without root privileges.
docker · high confidence
Initial repository setup with documentation, licensing, and build infrastructure
The repository has been initialized with the core structure for the Rust Training Books project. This includes the addition of MIT and CC-BY-4.0 license files, standard Microsoft compliance documents (Code of Conduct, Contributing, Security), and configuration files to support the mdbook build system and GitHub Pages deployment (.nojekyll, .gitignore, .dockerignore). The README has been expanded to provide a comprehensive guide for users, including a catalog of training books, setup instructions for local development, and links to the rendered documentation.
(repo-wide) · high confidence
New xtask tool for building and serving documentation sites
Added a new Rust-based xtask utility that automates the building, local serving, and deployment of multiple mdBook-based documentation sites. The tool supports commands to build all configured books into a local preview directory (site/), serve them locally on port 3000, or build them for GitHub Pages deployment (docs/). It includes safety checks for mdbook installation, handles directory cleanup, generates a landing page with categorized book cards, and creates a .nojekyll file to prevent Jekyll processing during GitHub Pages deployment.
xtask · high confidence
Dependencies
Add xtask build tooling with ctrlc dependency
Added a new Rust workspace and build tool (\xtask\) to manage project tasks. This includes a new \Cargo.toml\ workspace configuration, a dedicated \xtask\ package using the 2021 edition, and the \ctrlc\ crate (version 3.4) for safe signal handling.
(dependencies) · high confidence
Written by cca.canine.dev from the codebase's own history, inside the signed delivery this page is composed from.
How this codebase got here
Score
- CAI 54 → 53 (-0.5)
- Rubric changed (rubric-2026.10.5 → rubric-2026.11.4) — scores are not directly comparable.
Lenses
- Code Health 98 → 97 (-1.1)
- Architecture 69 → 69 (+0.0)
- Maturity 69 → 69 (+0.0)
- Readiness 32 → 32 (+0.0)
- Security 84 → 78 (-6.3)
Resolved (2)
- No ADRs found
- No tests found
New (1)
- No ADRs found (docker/Dockerfile)
Written by cca.canine.dev from the codebase's own history, inside the signed delivery this page is composed from.
Survey your own repository
microsoft/RustTraining was measured the same way every project in this corpus was: the same rubric, at a pinned commit, with the result published in full. Point a surveyor at a repository you know and see whether you agree with it.
About this page
- The score is its most recent published measurement, taken on 14 November 2026 at a pinned commit. It is not a live figure and does not change until the project is measured again.
- Measured at commit 26145f05b476acac57f3f1be69c730f7f0cd5fda — the exact code this score is about.
- Scored under rubric-2026.11.4 — the same rubric and the same method as every other entry in this index.
- Measured by Canine Code Analyzer (cca.canine.dev) using cca measure-2026.11.65+preprod-e1a3b69fc8ee.