Erich Blume b8104d75ad Move zk cards to docs/zk/ for documentation restructuring (#84 )

## Summary
- Move all existing zettelkasten cards from `docs/` to `docs/zk/` as a temporary holding area
- Update `zk-docs` mise task to look in the new location
- Add `docs/README.md` explaining the Diataxis-based restructuring plan and target audiences

## Context
This is phase 1 of a multi-phase documentation restructuring effort. The goal is to reorganize docs to follow the Diataxis framework while serving multiple audiences:
1. Erich (owner) - knowledge graph/zk
2. Claude/AI agents - memory and context enrichment
3. New external readers - high-level overview
4. Potential operators/contributors - onboarding
5. Replicators - people wanting to duplicate the approach

## Testing
- [x] Verified `mise run zk-docs` still works with the new path
- [x] Updated obsidian.nvim config (in ~/.config/nvim) to point to new path

## Note
The obsidian.nvim config change is outside this repo but was made as part of this work.

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

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

2026-02-03 09:13:50 -08:00

2.2 KiB

Raw Blame History

aliases

Miniflux Management Log

Miniflux is a minimalist RSS/Atom feed reader running in Kubernetes (minikube on indri).

Service Details

URL: https://feed.tail8d86e.ts.net
Namespace: miniflux
Image: ghcr.io/miniflux/miniflux:latest
Database: postgresql (CloudNativePG cluster at pg.tail8d86e.ts.net)
ArgoCD app: miniflux

Useful Commands

# View logs
kubectl -n miniflux logs -f deployment/miniflux

# Restart deployment
kubectl -n miniflux rollout restart deployment/miniflux

# Check health
curl https://feed.tail8d86e.ts.net/healthcheck

# Sync from ArgoCD
argocd app sync miniflux

ArgoCD Management

Miniflux is deployed via ArgoCD from argocd/manifests/miniflux/:

deployment.yaml - Deployment with environment configuration
service.yaml - ClusterIP service
ingress-tailscale.yaml - Tailscale Ingress for external access

Credentials

The miniflux database user password is auto-generated by CloudNativePG and stored in the blumeops-pg-app secret in the databases namespace.

To recreate the miniflux-db secret:

kubectl create secret generic miniflux-db -n miniflux \
  --from-literal=url="$(kubectl -n databases get secret blumeops-pg-app -o jsonpath='{.data.uri}' | base64 -d)"

Features

Keyboard shortcuts for efficient reading
Fever and Google Reader API compatible
Mobile-friendly web interface
OPML import/export
Content scraping for full articles

Backup

Feed subscriptions and read state stored in postgresql, backed up via borgmatic's postgresql_databases hook.

Log

Sun Jan 19 2026

Migrated to Kubernetes (Phase 4 of k8s migration)
Deployed via ArgoCD in miniflux namespace
Database connection via internal k8s DNS to CloudNativePG cluster
Exposed via Tailscale Ingress at feed.tail8d86e.ts.net
Removed brew miniflux service and ansible role from indri
Fixed table ownership issue after P3 restore (tables were owned by eblume, needed to be owned by miniflux)

Thu Jan 16 2026

Initial setup with Miniflux 2.x on brew
Connected to PostgreSQL 18 on localhost
Exposed via Tailscale at feed.tail8d86e.ts.net

2.2 KiB Raw Blame History