Skip to content

chore: drop committed large.md stress fixture, generate on demand#19

Merged
rrbe merged 2 commits into
masterfrom
chore/drop-large-fixture
Jun 1, 2026
Merged

chore: drop committed large.md stress fixture, generate on demand#19
rrbe merged 2 commits into
masterfrom
chore/drop-large-fixture

Conversation

@rrbe
Copy link
Copy Markdown
Owner

@rrbe rrbe commented Jun 1, 2026

fixtures/specialized/large.md was a 460 KB / 14,767-line generated stress document committed to the repo, but no automated test, bench, or CI step consumes it — it only exists for manual perf/stress runs. It is also fully regenerable from scripts/gen-large-fixture.sh in ~1.7s (deterministic, byte-identical output). So there's no reason to carry it in git.

Changes

  • Delete fixtures/specialized/large.md (−14,767 lines).
  • Gitignore fixtures/specialized/large.md so it can't be re-committed by accident.
  • Add a make large-fixture target that (re)generates it via the existing scripts/gen-large-fixture.sh.
  • Add docs/TESTING.md — a short testing guide (test layout, how to run via the Makefile, snapshot regeneration) with a Performance / stress testing section documenting the generate → test → delete workflow.

Verification

  • make check passes without the fixture (6 snapshot + 4 heading + CLI + unit tests all green) — confirms nothing depended on it.
  • make large-fixture regenerates the file; verified gitignored (git check-ignore matches, never shows as untracked) and byte-identical to the previously committed version.

Independent of the docs-cleanup PR #18 (touches different files; no conflict).

🤖 Generated with Claude Code

rrbe and others added 2 commits June 1, 2026 22:22
The 460 KB / 14.7k-line large.md was generated build output with zero
automated consumers (no test/bench/CI reads it). Stop committing it:

- delete fixtures/specialized/large.md and gitignore the path so it
  can't be re-committed
- add a `make large-fixture` target that regenerates it via the existing
  scripts/gen-large-fixture.sh (~1.7s, deterministic, byte-identical)
- document the generate → test → delete perf workflow in new
  docs/TESTING.md

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Review follow-up on the gitignore change in this PR:

- gen-large-fixture.sh said the output's `git diff` is meaningful and to
  "commit the diff" — now contradicts the gitignore. Reword the header
  comment and the generated file's HEADER to: gitignored, never commit,
  generate on demand and delete when done.
- TESTING.md snapshot-regen example hardcoded a $TMPDIR path (macOS-only;
  Linux temp_dir is /tmp). Tell the reader to copy the path the test
  prints instead.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@rrbe rrbe merged commit c116a82 into master Jun 1, 2026
5 checks passed
@rrbe rrbe deleted the chore/drop-large-fixture branch June 1, 2026 14:38
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