From e47a3b2ebb91f835094fd79ca5daaf08ec6d43d3 Mon Sep 17 00:00:00 2001 From: Erich Blume Date: Sat, 7 Mar 2026 08:59:51 -0800 Subject: [PATCH] Review and update review-documentation.md - Add last-reviewed date - Replace raw pulumi commands with mise task equivalents - Reference C0/C1/C2 change classification for making changes - Note that prek handles link validation automatically Co-Authored-By: Claude Opus 4.6 --- .../knowledgebase/review-documentation.md | 18 ++++++++---------- 1 file changed, 8 insertions(+), 10 deletions(-) diff --git a/docs/how-to/knowledgebase/review-documentation.md b/docs/how-to/knowledgebase/review-documentation.md index 9d031d3..d6dc064 100644 --- a/docs/how-to/knowledgebase/review-documentation.md +++ b/docs/how-to/knowledgebase/review-documentation.md @@ -1,6 +1,7 @@ --- title: Review Documentation modified: 2026-02-09 +last-reviewed: 2026-03-07 tags: - how-to - documentation @@ -85,23 +86,20 @@ If changes would be made, either the docs are stale or the host has drifted. Check for drift: ```bash -# Tailscale ACLs -cd pulumi/tailscale && pulumi preview - -# DNS (Gandi) -cd pulumi/gandi && pulumi preview +mise run tailnet-preview # Tailscale ACLs +mise run dns-preview # DNS (Gandi) ``` If changes are pending, investigate whether docs or infrastructure is stale. ## Making Changes -If a card needs updates: +If a card needs updates, classify the change (see [[agent-change-process]]): -1. Create a feature branch -2. Make the edits -3. Run `mise run docs-check-links` to verify links -4. Create a PR for review +- **C0 (small fix):** Edit, commit directly to main +- **C1/C2 (larger changes):** Create a feature branch and PR + +Link validation runs automatically via prek on commit. See [[update-documentation]] for publishing changes.