ls writing/ --by=type
tech writing
Proof I can document it: a deliberate range of real documentation, each piece tagged by its Diátaxis type so the range reads at a glance. Every one notes what it demonstrates.
- How-To Guide
TaskBoard User Manual
How to use TaskBoard day to day: create boards and tasks, move work across swimlanes, track progress and comments, and understand exactly what prints to the receipt printer.
demonstrates: A task-oriented end-user manual for a cross-platform app: creating boards and tasks, moving work across swimlanes, tracking progress and comments, and what prints to the receipt printer.
- Explanation Architecture Decision Record
TaskBoard Printer Integration: How a Move Becomes a Receipt
An explanation of TaskBoard's signature feature: why printing is a side effect of a state change rather than an endpoint, the two delivery modes (direct and a pull-based home agent), the one-formatter-two-backends design, and the Windows spooler gotcha that made receipts print late.
demonstrates: An architecture-decision explanation of why a physical print is modeled as a persisted-first, best-effort side effect of a domain event, and how one formatter interface drives both a local background task and a pull-based cloud agent.
- Reference Reference
TaskBoard Quick Reference
A one-page cheat sheet for TaskBoard: interface actions, the printing rules, data-model constraints, the full REST API endpoint table, and the backend configuration knobs.
demonstrates: A one-page lookup for TaskBoard: interface actions, printing rules, the data model, the REST API endpoint index, and backend configuration knobs.
- How-To Guide
Reaching a Home-Hosted App From Anywhere with Tailscale
How TaskBoard is reachable from outside the home network without opening a single port: a private WireGuard mesh (Tailscale) that keeps the API, and the printer it drives, at home while the phone connects from anywhere.
demonstrates: Secure remote access to a self-hosted service via a private mesh, chosen deliberately over public tunnels because this build has no authentication of its own.
- Reference API Reference
TaskBoard API Reference
Reference material for the TaskBoard REST API: resources, request and response shapes, status codes, and the endpoints that print a physical receipt on status change.
demonstrates: A complete, lookup-oriented API reference that stays factual and exhaustive without drifting into tutorial or opinion.
- How-To Guide
How to Deploy a Static Astro Site to S3 + CloudFront with Keyless OIDC
Step by step: provision a private S3 + CloudFront origin with Terraform, wire GitHub Actions to AWS through OIDC with no stored keys, gate the deploy on a Semgrep scan, and ship your first release.
demonstrates: Reproducible, keyless static-site delivery a competent reader can follow end to end.