WIP: docs: migrate context-vault documentation #54

Draft
martin wants to merge 1 commit from docs/migrate-context-vault into main
Owner

Work in progress: the documents are migrated and their metadata normalized, but the content still needs review before this is ready to merge.

What this does

  • Copies 26 relevant documents from context-vault (f84e585) into docs/, preserving filenames, directory layout, frontmatter, and content.
  • Adds docs/README.md as an index with source attribution and a warning that the material is historical.
  • Links the index from the top-level README.md and AGENTS.md.
  • Normalizes migrated metadata: plural category values, missing related lists, tag cleanup, broken relative paths, and reciprocal backlinks.

Document bodies are byte-identical to the source vault; only frontmatter changed.

Validation

  • 26/26 frontmatter blocks parse as valid YAML, no duplicate keys.
  • Categories: architecture=9, patterns=7, errors=6, learnings=3, decisions=1; 0 invalid.
  • 104 resolvable related edges, 0 non-reciprocal.
  • nix fmt -- docs makes no changes; git diff --check is clean.

Known follow-ups

  • 6 related entries point to vault documents not copied: shell-script-best-practices.md, nix-flake-multi-binary-discovery.md, nix-import-tree-pattern.md, and three woodpecker-extension/cluster docs. These are flagged in docs/README.md.
  • Content review: historical commands, paths, and configuration claims may be outdated.
  • Removing the vault tooling is tracked separately in #49.

Refs #48

Work in progress: the documents are migrated and their metadata normalized, but the content still needs review before this is ready to merge. ## What this does - Copies 26 relevant documents from [context-vault](https://code.martials.no/Personal/context-vault) (`f84e585`) into `docs/`, preserving filenames, directory layout, frontmatter, and content. - Adds `docs/README.md` as an index with source attribution and a warning that the material is historical. - Links the index from the top-level `README.md` and `AGENTS.md`. - Normalizes migrated metadata: plural category values, missing `related` lists, tag cleanup, broken relative paths, and reciprocal backlinks. Document bodies are byte-identical to the source vault; only frontmatter changed. ## Validation - 26/26 frontmatter blocks parse as valid YAML, no duplicate keys. - Categories: `architecture=9`, `patterns=7`, `errors=6`, `learnings=3`, `decisions=1`; 0 invalid. - 104 resolvable `related` edges, 0 non-reciprocal. - `nix fmt -- docs` makes no changes; `git diff --check` is clean. ## Known follow-ups - 6 `related` entries point to vault documents not copied: `shell-script-best-practices.md`, `nix-flake-multi-binary-discovery.md`, `nix-import-tree-pattern.md`, and three `woodpecker-extension`/`cluster` docs. These are flagged in `docs/README.md`. - Content review: historical commands, paths, and configuration claims may be outdated. - Removing the vault tooling is tracked separately in #49. Refs #48
docs: migrate context-vault documentation
All checks were successful
ci/woodpecker/pr/pr-review Pipeline was successful
fd084573ab
Copy 26 context-vault documents into docs/ and normalize their
frontmatter metadata. Add a documentation index and link it from the
top-level README and AGENTS.md.

Refs #48

Co-authored-by: OpenCode <opencode@anoma.ly>
All checks were successful
ci/woodpecker/pr/pr-review Pipeline was successful
This pull request is marked as a work in progress.
This branch is out-of-date with the base branch
View command line instructions

Checkout

From your project repository, check out a new branch and test the changes.
git fetch -u origin 'docs/migrate-context-vault:docs/migrate-context-vault'
git switch 'docs/migrate-context-vault'

Merge

Merge the changes and update on Forgejo.

Warning: The "Autodetect manual merge" setting is not enabled for this repository, you will have to mark this pull request as manually merged afterwards.

git switch 'main'
git merge --no-ff 'docs/migrate-context-vault'
git switch 'docs/migrate-context-vault'
git rebase 'main'
git switch 'main'
git merge --ff-only 'docs/migrate-context-vault'
git switch 'docs/migrate-context-vault'
git rebase 'main'
git switch 'main'
git merge --no-ff 'docs/migrate-context-vault'
git switch 'main'
git merge --squash 'docs/migrate-context-vault'
git switch 'main'
git merge --ff-only 'docs/migrate-context-vault'
git switch 'main'
git merge 'docs/migrate-context-vault'
git push origin 'main'
Sign in to join this conversation.
No reviewers
No milestone
No project
No assignees
1 participant
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set

Reference
Personal/nixos-configuration!54
No description provided.