blumeops

eblume/blumeops

Fork 0

Commit graph

Author	SHA1	Message	Date
Erich Blume	c130f72204	Update all docs titles to human-readable and delete test cards Titles now use proper casing (e.g. "Borgmatic" instead of "borgmatic", "AI Assistance Guide" instead of "ai-assistance-guide") and match file stems so wiki-links work without alternate anchor text. Also removes the title-test-alpha/beta cards and their reference index entry. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>	2026-02-07 21:40:22 -08:00
Erich Blume	3da455e49c	Enforce unique doc filenames and simple wiki-links (#109 ) ## Summary - Rename section index files to match their titles (tutorials.md, reference.md, how-to.md, explanation.md) so all filenames are unique - Convert all ~47 path-based wiki-links to simple filename format across 15 files - Update doc-filenames task to no longer skip index.md files - Update doc-links task to reject path-based links containing '/' This ensures all wiki-links work correctly in obsidian.nvim by making links resolvable by filename alone. ## Testing - `mise run doc-filenames` - all unique - `mise run doc-links` - no broken or path-based links - `mise run doc-titles` - no duplicates Reviewed-on: https://forge.ops.eblu.me/eblume/blumeops/pulls/109	2026-02-04 17:21:34 -08:00
Erich Blume	7ebac4aef6	Add Phase 3 tutorials with audience targeting (#94 ) ## Summary - Create tutorials directory structure with index page - Add 5 main tutorials targeting different audiences: - what-is-blumeops (Reader, AI) - High-level orientation - exploring-the-docs (All) - Navigation guide - ai-assistance-guide (AI, Owner) - Context for AI-assisted operations - contributing (Contributor) - First contribution workflow - replicating-blumeops (Replicator) - Overview for building similar setup - Add 4 replication sub-tutorials: - tailscale-setup, kubernetes-bootstrap, argocd-config, observability-stack - Update README.md to mark Phase 3 complete - Add changelog fragment Each tutorial explicitly identifies its target audiences and links to reference material rather than re-explaining concepts. ## Deployment and Testing - [x] All pre-commit hooks pass (doc-links validates wiki links) - [ ] Build docs via workflow to verify rendering - [ ] Review content for accuracy 🤖 Generated with [Claude Code](https://claude.com/claude-code) Reviewed-on: https://forge.ops.eblu.me/eblume/blumeops/pulls/94	2026-02-03 18:51:57 -08:00

Author

SHA1

Message

Date

Erich Blume

c130f72204

Update all docs titles to human-readable and delete test cards

Titles now use proper casing (e.g. "Borgmatic" instead of "borgmatic",
"AI Assistance Guide" instead of "ai-assistance-guide") and match file
stems so wiki-links work without alternate anchor text. Also removes
the title-test-alpha/beta cards and their reference index entry.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

2026-02-07 21:40:22 -08:00

Erich Blume

3da455e49c

Enforce unique doc filenames and simple wiki-links (#109 )

## Summary
- Rename section index files to match their titles (tutorials.md, reference.md, how-to.md, explanation.md) so all filenames are unique
- Convert all ~47 path-based wiki-links to simple filename format across 15 files
- Update doc-filenames task to no longer skip index.md files
- Update doc-links task to reject path-based links containing '/'

This ensures all wiki-links work correctly in obsidian.nvim by making links resolvable by filename alone.

## Testing
- `mise run doc-filenames` - all unique
- `mise run doc-links` - no broken or path-based links
- `mise run doc-titles` - no duplicates

Reviewed-on: https://forge.ops.eblu.me/eblume/blumeops/pulls/109

2026-02-04 17:21:34 -08:00

Erich Blume

7ebac4aef6

Add Phase 3 tutorials with audience targeting (#94 )

## Summary
- Create tutorials directory structure with index page
- Add 5 main tutorials targeting different audiences:
  - **what-is-blumeops** (Reader, AI) - High-level orientation
  - **exploring-the-docs** (All) - Navigation guide
  - **ai-assistance-guide** (AI, Owner) - Context for AI-assisted operations
  - **contributing** (Contributor) - First contribution workflow
  - **replicating-blumeops** (Replicator) - Overview for building similar setup
- Add 4 replication sub-tutorials:
  - tailscale-setup, kubernetes-bootstrap, argocd-config, observability-stack
- Update README.md to mark Phase 3 complete
- Add changelog fragment

Each tutorial explicitly identifies its target audiences and links to reference material rather than re-explaining concepts.

## Deployment and Testing
- [x] All pre-commit hooks pass (doc-links validates wiki links)
- [ ] Build docs via workflow to verify rendering
- [ ] Review content for accuracy

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

Reviewed-on: https://forge.ops.eblu.me/eblume/blumeops/pulls/94

2026-02-03 18:51:57 -08:00

3 commits