My GitHub Pages website.

• decisions - Decision records
• docs - Markdown files for the mdBook site
• packages - npm packages
  • presentations - Reveal.js Markdown presentations
• theme - Theming for mdBook

1. Install mdbook: mdBook installation

   cargo install mdbook

   Note: This project does not set up a Cargo.toml. Instead, it assumes a local installation.

2. Preview the book. This will rebuild on changes.

   mdbook serve

3. Explore other mdbook commands in the documentation

4. Build the presentations. You must install npm dependencies first (npm ci).

   npm run build

The mdbook GitHub Action deploys the generated static website. It runs mdbook build and uploads the book directory.