Review build-jobsync-container, refine docs-preview tooling
- Review build-jobsync-container.md: fix nonexistent `mirror-sync` task reference (Forgejo mirrors sync automatically), mark reviewed - Remove bat hint from docs-review checklist (output not visible in agent sessions), keep docs-preview hint as user-facing step - Simplify review-documentation.md visual preview section - Fix Python 3.14 tarfile deprecation warning in docs-preview Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
This commit is contained in:
parent
d01a165b91
commit
d5a92fead8
4 changed files with 7 additions and 12 deletions
|
|
@ -1,6 +1,7 @@
|
|||
---
|
||||
title: Build JobSync Container
|
||||
modified: 2026-03-08
|
||||
modified: 2026-03-11
|
||||
last-reviewed: 2026-03-11
|
||||
tags:
|
||||
- how-to
|
||||
- jobsync
|
||||
|
|
@ -19,7 +20,7 @@ The derivation is at `containers/jobsync/default.nix`. It uses `buildNpmPackage`
|
|||
|
||||
## Upgrading JobSync
|
||||
|
||||
1. Update the forge mirror: `mise run mirror-sync jobsync`
|
||||
1. Verify the forge mirror is current: check `https://forge.eblu.me/mirrors/jobsync` (mirrors sync automatically)
|
||||
2. Update `version` in `default.nix` to match the new upstream tag
|
||||
3. Clear `hash` in `fetchgit` (set to `""`), build, grab the correct hash from the error
|
||||
4. Clear `npmDepsHash` (set to `""`), build again, grab the correct hash
|
||||
|
|
|
|||
|
|
@ -94,11 +94,7 @@ If changes are pending, investigate whether docs or infrastructure is stale.
|
|||
|
||||
## Visual Preview
|
||||
|
||||
After reviewing and editing a card, visually verify the rendered output.
|
||||
|
||||
**Quick scan (agent):** Have the agent display the card with `bat` for a terminal-based visual check.
|
||||
|
||||
**Full rendered preview:** Build the entire Quartz docs site locally and open directly to the card:
|
||||
After reviewing and editing a card, visually verify the rendered output. This step is for the human reviewer — build the full Quartz docs site locally and open directly to the card:
|
||||
|
||||
```bash
|
||||
mise run docs-preview how-to/knowledgebase/review-documentation
|
||||
|
|
|
|||
Loading…
Add table
Add a link
Reference in a new issue