Computer Setup Information

This repository is organized around a role-based setup path.

Start here, choose a primary Setup Plan, then follow that plan into the relevant Resource Catalog material and curated Inventory Export snapshots. Historical material belongs in reference, not in the active setup path.

Primary setup plans

• Linux — automated base provisioning plus manual configuration.
• macOS — manual application and development-environment setup.
• Android — manual source and privacy decisions.

Role directories

• Setup Plans — ordered human-facing routes for each active entry point.
• Resource Catalog — reusable setup resources and inventory records.
• Inventory Exports — curated snapshots of actual machine and device state.
• Reference material — historical or contextual guides that are not part of the active setup path.

Other setup areas

• Synology
• Printers and scanners
• Self-hosting
• Obsolescence review queue

Validation

Run the read-only documentation checks before committing documentation changes:

python3 scripts/validate_docs.py

The validator requires Python 3.9 or newer and takes an optional --root for checking a copy of the repo. Its own test suite runs with:

python3 -m unittest discover -s scripts -p 'test_*.py'