Skip to content
CAI
Software that uses CAICheck a score

microsoft/RustTraining

53.4

Weak · 14 November 2026

448

lines of production code

Rust

with JavaScript

5

measurements over time

CAI band scale
CAI trend line
CAI lens gauges

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.