Commit graph

6 commits

Author SHA1 Message Date
b3b0e110c8 Add docs/index.md instead of generating in workflow
Keep the index page as a normal doc file that can be edited,
rather than generating it during the build workflow.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-02-03 08:52:13 -08:00
fe161e547c Move Quartz config files to docs/
Keep repo root cleaner by storing quartz.config.ts and quartz.layout.ts
in docs/ alongside the content they configure. Updated workflow to copy
from the new location.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-02-03 08:40:21 -08:00
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
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
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
c89e69e25f Add docs/ with blumeops zk cards (#82)
## Summary
- Move 21 blumeops-tagged zettelkasten cards from ~/code/personal/zk/ to docs/
- Create symlink ~/code/personal/zk/blumeops -> blumeops/docs for obsidian integration
- Update zk-docs mise task to read from local docs/ directory
- Add blumeops workspace to obsidian.nvim config (strict=true)

## Benefits
- Docs are now git-managed in the blumeops repo (visible on GitHub)
- Wiki links between blumeops docs continue to work via symlink
- obsidian-sync isolation: docs don't sync to work laptop
- Direct editing via obsidian.nvim with dedicated workspace

## Testing
- [x] Files moved to docs/ (21 files)
- [x] Symlink created: ~/code/personal/zk/blumeops -> blumeops/docs
- [x] zk-docs mise task updated and working
- [ ] Verify obsidian.nvim link resolution (after merge)
- [ ] Verify obsidian backlinks work

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Reviewed-on: https://forge.ops.eblu.me/eblume/blumeops/pulls/82
2026-02-02 21:40:53 -08:00