eblume/blumeops
1
1
Fork 0
Code Issues Pull requests Projects Releases 83 Packages Wiki Activity Actions
173 commits 82 branches 160 tags 8.7 MiB
Commit graph

3 commits

Author SHA1 Message Date
Erich Blume
0080d1c54a Add Quartz documentation build infrastructure 
Phase 1a infrastructure for building and hosting BlumeOps docs:

- Add quartz.config.ts and quartz.layout.ts for Quartz configuration
- Add containers/quartz/ with nginx-based static site server that
  downloads release bundles on startup via DOCS_RELEASE_URL env var
- Add .forgejo/workflows/build-blumeops.yaml workflow (manual trigger)
  that builds Quartz site and creates Forgejo release with tarball
- Update docs/README.md with finalized tooling choice and split
  Phase 1 into 1a (CI) and 1b (CD/hosting)

The architecture separates content versioning from infrastructure:
- Releases are versioned BlumeOps releases (v1.0.0, etc.)
- Doc tarballs are attached as release assets
- The quartz container is a generic static site server

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
 2026-02-03 08:38:12 -08:00
Erich Blume
38dae76cb9 Expand docs/README.md with full restructuring plan 
Add comprehensive phased plan for documentation restructuring:
- Phase 1: Foundation (current) - zk migration, tooling selection
- Phase 2: Tutorials - learning-oriented content
- Phase 3: How-to Guides - task-oriented instructions
- Phase 4: Reference - technical descriptions
- Phase 5: Explanation - concepts and decisions
- Phase 6: Integration & Cleanup

Also includes:
- Tooling evaluation table (Quartz, MkDocs, mdBook, Hugo, Docusaurus)
- Requirements (Obsidian compatibility, wiki-links, HTML/PDF output)
- Note on project naming (BlumeOps / blumeops / Blue Mops)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
 2026-02-03 08:08:46 -08:00
Erich Blume
7112297150 Move zk cards to docs/zk/ for documentation restructuring 
Phase 1 of docs restructuring: move all zettelkasten cards to a
temporary docs/zk/ subdirectory while preparing to build a new
Diataxis-based documentation structure.

- Move all existing markdown files from docs/ to docs/zk/
- Update zk-docs mise task to look in the new location
- Add docs/README.md explaining the restructuring plan

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
 2026-02-03 07:57:47 -08:00