blumeops/docs/how-to
Erich Blume 81690dae0f Review add-ansible-role doc (#185)
## Summary
- Replace `op item get --fields` with `op read` for secrets (matches playbook and CLAUDE.md guidance)
- Change `tags: [<role>]` to `tags: <role>` to match actual playbook style
- Remove redundant `listen:` from handler example, add `changed_when: true`
- Name handler after specific service (e.g. `Restart <service>`) to match real roles
- Add `last-reviewed: 2026-02-13` frontmatter

## Also noted (not fixed here)
Two other docs still use the old `op item get` pattern:
- `docs/how-to/troubleshooting.md:72` (ArgoCD login command)
- `docs/how-to/gandi-operations.md:35` (Gandi token export)

These can be fixed in their own review cycles.

Reviewed-on: https://forge.ops.eblu.me/eblume/blumeops/pulls/185
2026-02-13 16:54:42 -08:00
..
knowledgebase Fix frontmatter field name for Quartz date display (#158) 2026-02-11 16:45:12 -08:00
plans Add reference/tools/ category with Dagger, ArgoCD CLI, Ansible, and Pulumi cards (#178) 2026-02-12 19:18:46 -08:00
add-ansible-role.md Review add-ansible-role doc (#185) 2026-02-13 16:54:42 -08:00
create-release-artifact-workflow.md Add release artifact workflow how-to and changelog fragments (#170) 2026-02-12 11:20:05 -08:00
deploy-k8s-service.md Update deploy-k8s-service doc with ProxyGroup ingress pattern (#166) 2026-02-11 21:10:42 -08:00
expose-service-publicly.md Update CV release to v1.0.3, add X-Clacks-Overhead header (#176) 2026-02-12 17:08:22 -08:00
gandi-operations.md Fix frontmatter field name for Quartz date display (#158) 2026-02-11 16:45:12 -08:00
how-to.md Add release artifact workflow how-to and changelog fragments (#170) 2026-02-12 11:20:05 -08:00
manage-flyio-proxy.md Fix frontmatter field name for Quartz date display (#158) 2026-02-11 16:45:12 -08:00
restart-indri.md Fix frontmatter field name for Quartz date display (#158) 2026-02-11 16:45:12 -08:00
restore-1password-backup.md Fix frontmatter field name for Quartz date display (#158) 2026-02-11 16:45:12 -08:00
troubleshooting.md Fix frontmatter field name for Quartz date display (#158) 2026-02-11 16:45:12 -08:00
update-documentation.md Add reference/tools/ category with Dagger, ArgoCD CLI, Ansible, and Pulumi cards (#178) 2026-02-12 19:18:46 -08:00
update-tailscale-acls.md Fix frontmatter field name for Quartz date display (#158) 2026-02-11 16:45:12 -08:00
use-pypi-proxy.md Fix frontmatter field name for Quartz date display (#158) 2026-02-11 16:45:12 -08:00