Root Access Policy Handbook

The official policy handbook for Root Access Hackerspace in Fresno, CA. Published at handbook.rootaccess.org.

Built with Sphinx, the Read The Docs theme, and MyST for Markdown parsing. Every push to main triggers a GitHub Action that builds and deploys to GitHub Pages.

Local Development

Install dependencies:

pip install -r requirements.txt

Build the handbook:

make html

Output lands in build/html/. Open build/html/index.html in a browser to preview.

Live-reloading dev server:

sphinx-autobuild source build/html

Project Structure

source/
  index.md          # Welcome page and table of contents
  membership.md     # Membership information
  policies/         # Rules & policies (conduct, guests, lockers, etc.)
  safety/           # Health & safety guidelines
  events/           # Classes, community events, and event hosting
  conf.py           # Sphinx configuration
  _static/          # Static assets (logo, favicon, PDFs)

Deployment

Pushes to main automatically build and publish to GitHub Pages via the workflow in .github/workflows/. The site deploys to handbook.rootaccess.org using ghp-import.

License

This work is licensed under a Creative Commons Attribution-NonCommercial-ShareAlike 4.0 International License.