Operating Systems Documentation

A comprehensive guide to operating systems based on OSTEP (Operating Systems: Three Easy Pieces), transformed into engaging, learnable content.

Quick Start

# Install dependencies
npm install

# Start development server
npm start

# Build for production
npm run build

Structure

operating-systems/
├── docs/
│   ├── virtualization/    # CPU & Memory virtualization (17 chapters)
│   ├── concurrency/       # Threads & synchronization (8 chapters)
│   └── persistence/       # I/O & file systems (13 chapters)
├── src/
│   └── css/custom.css     # CVS red theme
├── static/img/            # Assets
├── docusaurus.config.ts   # Site configuration
└── sidebars.ts            # Navigation structure

Deployment

Automatically deploys to GitHub Pages on push to master via GitHub Actions.

Manual Setup

1. Update docusaurus.config.ts:

   • Set url to your GitHub Pages URL
   • Set organizationName to your GitHub username
   • Set projectName to your repo name

2. Enable GitHub Pages in repo settings:

   • Go to Settings → Pages
   • Source: GitHub Actions

Content Guidelines

See CLAUDE.md for content structure and formatting rules.

Credits

Based on "Operating Systems: Three Easy Pieces" by Remzi H. Arpaci-Dusseau and Andrea C. Arpaci-Dusseau.