microsoft/RustTraining

This system is a static documentation platform that hosts and serves multiple Rust training books using the mdBook framework. It provides a curated collection of educational materials, including guides for C\# developers and advanced topics like async Rust and type-driven correctness, enhanced with interactive Mermaid diagrams. The infrastructure supports local development and self-hosting via Docker, while a custom Rust-based xtask utility automates the building, previewing, and deployment of these sites to GitHub Pages.

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

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

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

Users can now self-host the book collection using Docker, providing an alternative to GitHub Pages for environments behind firewalls or on internal networks. 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 also included to simplify local deployment, allowing users to run the service with \docker compose -f docker/compose.yaml up --build\.

docker · high confidence

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

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

Added a new Rust workspace containing an xtask utility that depends on the ctrlc crate (version 3.4) for signal handling.

(dependencies) · high confidence

Written by watchdog.canine.dev from the codebase's own history, inside the signed delivery this page is composed from.

• CAI 61 → 54 (-6.4)
• Rubric changed (rubric-2026.09.8 → rubric-2026.09.16) — scores are not directly comparable.

• Code Health 97 → 97 (+0.0)
• Architecture 69 → 69 (+0.0)
• Maturity 72 → 72 (+0.0)
• Readiness 46 → 32 (-14.1)
• Security 80 → 83 (+2.9)

• Dependency hygiene PARTLY measured — Cargo dependencies read, no committed lock to grade for currency

Written by watchdog.canine.dev from the codebase's own history, inside the signed delivery this page is composed from.

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.