$ show google/comprehensive-rust
This repository contains the source code for Comprehensive Rust, a multi-day Rust course developed by the Android team at Google. It is structured as an mdBook with slides, speaker notes, interactive code examples, and exercises. The course covers Rust fundamentals, Android and Chromium integration, bare-metal development, concurrency, async, unsafe Rust, and idiomatic patterns. The codebase includes custom mdBook preprocessors (mdbook-course for structured course scheduling, mdbook-exerciser for extracting exercise starter files), a developer automation tool (xtask), and a comprehensive CI/CD pipeline that builds the book in multiple languages, runs Rust tests via Bazel and Cargo, and performs browser-based WebDriverIO tests. While the primary output is educational content, the tooling infrastructure is well-engineered and demonstrates reusable patterns for structured documentation and exercise management. The repository is actively maintained with frequent commits, issue triage, and translation support for over 17 languages.
The LLM identified 2 files worth highlighting for reuse:
Defines the core data model for the course hierarchy (Courses -> Course -> Session -> Segment -> Slide) by parsing YAML frontmatter from markdown files. This component is reusable for any mdBook-based educational material that needs structured scheduling, outline generation, and duration tracking. It demonstrates a clean separation of content metadata from presentation, enabling automated generation of session outlines and course schedules.
Implements an mdBook renderer that scans markdown content for `<!-- File ... -->` comments and extracts the enclosed code blocks into separate starter files. This pattern is reusable for any documentation project that wants to provide downloadable exercise templates directly from the source material. It is self-contained, depends only on mdBook's renderer API, and can be adapted to different comment conventions.