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

4 commits

Author SHA1 Message Date
Erich Blume
cad3b2d6e6 Add Phase 4: how-to guides documentation 
Create task-oriented how-to guides for common BlumeOps operations:
- deploy-k8s-service: Quick reference for k8s deployments
- add-ansible-role: Adding new Ansible roles for indri
- update-tailscale-acls: Modifying Tailscale ACL policies
- troubleshooting: Diagnosing and fixing common issues

Also updates exploring-the-docs to include How-to section links.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
 2026-02-03 20:08:27 -08:00
Erich Blume
d0e37b8b91 Fix towncrier fragment format: use flat <name>.<type>.md 
The towncrier config uses the type's `directory` field as the type
identifier in filenames, NOT as subdirectories. Correct format:
  docs/changelog.d/<name>.<type>.md

NOT:
  docs/changelog.d/<type>/<name>.md

- Move fragments to root with type suffix
- Remove empty type subdirectories
- Fix CLAUDE.md instructions
- Fix tutorial examples in contributing.md and ai-assistance-guide.md

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
 2026-02-03 19:06:14 -08:00
Erich Blume
c036562dfe Fix towncrier fragment naming and CLAUDE.md instructions 
Fragments in subdirectories should be named `<name>.md`, not
`<name>.<type>.md` - the type is already indicated by the directory.

- Rename feature/auto-deploy-docs.feature.md → feature/auto-deploy-docs.md
- Rename misc/+container-tag-no-confirm.misc.md → misc/+container-tag-no-confirm.md
- Update CLAUDE.md with correct fragment path format

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
 2026-02-03 19:00:26 -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