Skip to content

README.md documents the contributor workflow that CI enforces: installing with pip install -e ".[test]", running `pyth - #7

Merged
unohee merged 1 commit into
mainfrom
goal/06-readme-md-documents-the-contri
Nov 2, 2026
Merged

unohee merged 1 commit into
mainfrom
goal/06-readme-md-documents-the-contri

Conversation

@unohee

@unohee unohee commented Nov 2, 2026

Copy link
Copy Markdown
Contributor

Milestone of an auto-claude run.

Check: grep -qF 'pip install -e ".[test]"' README.md && grep -qF 'pytest -m "not slow"' README.md && grep -qF 'python scripts/check_docs.py' README.md && ~/RTX_ENV/bin/python scripts/check_docs.py && systemd-run --user --scope -q -p MemoryMax=6G ~/RTX_ENV/bin/python -m pytest -m "not slow" -q -p no:cacheprovider

Plan: .claude/auto-plan.md (local to the run).

Adds a README "Development" section with a fenced bash block:
pip install -e ".[test]", python -m pytest -m "not slow", and
python scripts/check_docs.py, plus the system tools CI installs
(ffmpeg, libsndfile1, libchromaprint-tools for fpcalc).

check_docs.py extracts the block (README.md:226-227); injecting a bogus
flag into the check_docs command makes it report
"`scripts/check_docs.py` does not accept --bogus", so the block is verified.

Assumptions:
- The section sits just before License, after the protocol docs, because
  it is for contributors, not benchmark users.
- pytest is on check_docs' ignore list (third-party), so only the
  check_docs command's flags are machine-verified; --skip-flags is shown in
  prose and exists in its parser.
@unohee
unohee merged commit 3582cd3 into main Nov 2, 2026
1 check passed
@unohee
unohee deleted the goal/06-readme-md-documents-the-contri branch November 2, 2026 16:37
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