blumeops/docs/how-to
Erich Blume 03bda41de4 Fix Quartz build to preserve git history for accurate file dates (#105)
## Summary

Fixes the "isn't yet tracked by git, dates will be inaccurate" warnings in the Build docs step by restructuring how Quartz builds the documentation.

## Problem

Previously, we copied docs into Quartz's content folder. Since this was inside a fresh Quartz clone with no history of our files, the `CreatedModifiedDate` plugin couldn't determine accurate dates.

## Solution

Build Quartz from within the blumeops repo instead:
1. Copy Quartz's build system (quartz/, package.json, etc.) into the workspace
2. Symlink `content` -> `docs` (preserves git history)
3. Symlink `docs/CHANGELOG.md` -> `../CHANGELOG.md`
4. Build from workspace root where git can trace file history
5. Clean up artifacts after creating tarball

## Deployment and Testing

- [ ] Run build workflow and verify no "not tracked by git" warnings
- [ ] Verify file dates appear correctly on built docs site

Reviewed-on: https://forge.ops.eblu.me/eblume/blumeops/pulls/105
2026-02-04 08:25:46 -08:00
..
knowledgebase Add doc-random task and documentation improvements (#98) 2026-02-03 21:17:58 -08:00
add-ansible-role.md Add Phase 4: how-to guides documentation (#95) 2026-02-03 20:17:24 -08:00
deploy-k8s-service.md Add Phase 4: how-to guides documentation (#95) 2026-02-03 20:17:24 -08:00
index.md Add doc-random task and documentation improvements (#98) 2026-02-03 21:17:58 -08:00
troubleshooting.md Rename indri-services-check to services-check (#103) 2026-02-04 07:49:15 -08:00
update-documentation.md Fix Quartz build to preserve git history for accurate file dates (#105) 2026-02-04 08:25:46 -08:00
update-tailscale-acls.md Add Phase 4: how-to guides documentation (#95) 2026-02-03 20:17:24 -08:00
use-pypi-proxy.md Complete Phase 6: documentation cleanup and integration (#97) 2026-02-03 20:52:37 -08:00