docs: add frontmatter convention (title, collections) to handbooks

Each handbook now opens with a flat YAML frontmatter block so the
two ingest-time values that actually describe the document -
title and collections - live with it instead of being retyped by
hand at admission time. That drift was real, not hypothetical:
the ingest recipe documented `--collection dev-practice` while the
actual admission used `handbooks`.

`version` deliberately stays out of frontmatter - a file can't
contain the hash of the commit that writes it - and remains a
value the ingest recipe computes fresh, now scoped per-file
(git log -1 -- <file>) rather than the whole repo's HEAD.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_011EBCcjJvEvhpToahqdsLLA

This commit is contained in:

Mikkeli Matlock

2026-08-22 17:05:23 +09:00

parent 4ed06c7e4b

commit 57e03af2b9

3 changed files with 61 additions and 14 deletions

									
										failure-handling.md
									
		+5
		
												View File
												
				@@ -1,3 +1,8 @@

				---

				title: Failure handling

				collections: [handbooks, dev-practice]

				---

				# Failure handling

				> Composed 2026-08-22. General practice, not tied to any one project or language.