Skip to content

2026-07-26 - turning starter notes into a public docs structure

Goal

Convert my initial private setup documents into a public-safe documentation site that is easier to maintain over time.

Change

I reorganized the project into:

  • architecture
  • labs
  • infrastructure and services
  • a lightweight journal for ongoing updates

I also simplified the site navigation so it feels more like a clear reference structure than a themed landing page.

What I learned

  • the original notes had good technical detail but were too dense for a public-facing site
  • the best public version is shorter, more structured, and centered on practical reference pages
  • documenting mistakes and validation steps is just as valuable as documenting the final result

Follow-up

Next useful additions:

  • service deployment pages
  • monitoring notes
  • backup strategy
  • identity and access management
  • diagrams once the environment settles