Skip to content

docs: READMEs, CONTRIBUTING and format references - #49

Merged
sp00ktober merged 5 commits into
mainfrom
docs/71
Oct 4, 2026
Merged

sp00ktober merged 5 commits into
mainfrom
docs/71

Conversation

@sp00ktober

Copy link
Copy Markdown
Contributor

Docs for going public.

  • READMEs: every package and app has one with the same shape: what it is, Install or Build, Example, Status, Licence. modkit-testing gets its first. Root README: a layout table that matches the tree, and a Getting started section. Nothing is prebuilt; each README says how to build its part.
  • CONTRIBUTING.md: setup, hooks, tests with and without game data, commit style, no game data, licences.
  • docs/formats/: references for DATA.BIN, PAC, PMO, TMH, skeleton and animation, and stages. Each one names the class that reads it, and every table was checked against the code.
  • Comments and UI text say what, not when: about 20 lines.

Tested: pre-commit on all files; pytest with game data, 1913 passed. Every command the READMEs name was run, except the Blender build, studio/docker/run.sh, mhfu start and mhp-formats extract, which were checked against their code only.

🤖 Generated with Claude Code

sp00ktober and others added 5 commits October 4, 2026 23:34
The README says which repositories this one replaces, fixes the layout table, and adds getting
started and wheels. CONTRIBUTING covers setup, the hooks, tests with and without game data,
commit style, the no-game-data rule and licences.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Each says what it is, how to install or build it from a clone, a short example, its status
and its licence. modkit-testing gets one; mhfu lists the abi and live stage commands; the
remote-debugger menu path follows PPSSPP 1.20.4.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Provenance and session narration give way to the fact and its limit ("unverified in game").
The hitzone note now agrees with the studio: grid writes take effect, hit-volume edits are
unverified.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
…stages

Layout tables checked against mhp-formats, mhfu-port, mhfu and the studio,
with an index and the conventions they share.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@sp00ktober
sp00ktober merged commit 60a59a5 into main Oct 4, 2026
5 checks passed
@sp00ktober
sp00ktober deleted the docs/71 branch October 4, 2026 21:59
@sp00ktober
sp00ktober restored the docs/71 branch October 4, 2026 21:59
@sp00ktober
sp00ktober deleted the docs/71 branch October 4, 2026 22:00
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