Developer Wisdom

A commonplace book of software engineering wisdom, built with mdbook.

Dependencies

Install these tools to build and work on this project:

Tool	Purpose	Install
mdbook	Build the book	cargo install mdbook
dprint	Format markdown	cargo install dprint
rumdl	Lint markdown	cargo install rumdl
lefthook	Git hooks	brew install lefthook
cocogitto	Validate commits	cargo install cocogitto
vale	Grammar linting	brew install vale
just	Run commands	brew install just or cargo install just
rsync	Deploy to server	Built-in on macOS/Linux

Getting Started

# Install dependencies
cargo install mdbook dprint rumdl cocogitto just
brew install lefthook vale

# Install git hooks
lefthook install

# Build the book
just build

# Serve locally
just serve

# Format markdown
just fmt

# Check formatting (CI)
just fmt-check

# Lint markdown
rumdl check src/

# Lint prose (grammar, style)
vale src/

Project Structure

• src/ - Markdown source files
• book/ - Built output (gitignored)
• dprint.json - Markdown formatter config
• lefthook.yml - Git hook config
• .rumdl.toml - Markdown linter config
• justfile - Build and deploy commands
• AGENTS.md - Guidelines for AI agents

Deploy

just deploy

Requires server credentials in .env file.