Skip to content

Consolidate the documentation around one owner per subject - #31

Merged
snkmcb merged 1 commit into
mainfrom
docs/consolidation
Sep 24, 2026
Merged

snkmcb merged 1 commit into
mainfrom
docs/consolidation

Conversation

@snkmcb

@snkmcb snkmcb commented Sep 24, 2026

Copy link
Copy Markdown
Member

Applies the motion documentation consolidation policy here, beside animu-sphere/usd-vrm-plugins#233.

  • Root README follows the shared shape (Scope, Architecture, Components, Documentation, Build, License). It states that this repository is the canonical owner of generic motion semantics, and drops the "v0.5.0 is published" status block. docs/README.md no longer names the latest release.
  • Documentation guidelines add the cross-repository rule (link a sibling's contract, never restate it), the root README rules, the archive category, and "contracts move to the current owner; evidence stays with its provenance".
  • Links into usd-vrm-plugins follow its reorganization: its motion plans now live under docs/archive/motion-split/, and its MOTION_CONTRACT.md is a superseded stub, so the anchors this repository cites for carried evidence point at the last full revision (e98db79). EXEC_CONTRACT §8 says so.
  • Roadmap: the consumers' deletions, the execMotion publication, the parity reproduction and motion-connectors' consumption are done, so they leave current.md; what remains is the first non-VRM consumer and the work beyond the imports.

python scripts/check_docs.py passes. Merge after usd-vrm-plugins#233, whose archive paths these links target.

🤖 Generated with Claude Code

The root README follows the shared shape and states ownership instead of
release status; the documentation guidelines add the cross-repository
rule and the root README rules. Links into usd-vrm-plugins' motion
documents follow them to its archive, or to the last revision of a
superseded contract, and the roadmap is brought up to what is done.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@snkmcb
snkmcb merged commit d5f0ee9 into main Sep 24, 2026
6 checks passed
@snkmcb
snkmcb deleted the docs/consolidation branch September 24, 2026 19:44
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant