Skip to content

docs(readme): fix broken evals link#900

Open
santhiprakash wants to merge 1 commit into
CodebuffAI:mainfrom
santhiprakash:docs/readme-eval-link
Open

docs(readme): fix broken evals link#900
santhiprakash wants to merge 1 commit into
CodebuffAI:mainfrom
santhiprakash:docs/readme-eval-link

Conversation

@santhiprakash

Copy link
Copy Markdown

Problem\n\nREADME.md links to evals/README.md on line 13, but that file does not exist. Clicking the "our evals" link from the rendered README results in a 404.\n\n## Triage / Root cause\n\nPR #255 ([chore] Update readmes) introduced the [our evals](evals/README.md) link, but the target file was never present in the public tree. The actual evaluation documentation lives at evals/buffbench/README.md.\n\n## Fix\n\nUpdate the link target from evals/README.md to evals/buffbench/README.md. This is the minimal, existing doc that describes the BuffBench evaluation framework referenced by the 61% vs 53% comparison.\n\n## Verification\n\n- python3 markdown link scan of README.md, CONTRIBUTING.md, and docs/**/*.md* confirmed evals/README.md is the only missing relative link.\n- ls -l evals/buffbench/README.md confirms the new target exists and documents the evaluation framework.\n- python3 ../scripts/preflight_ship.py --repo CodebuffAI/codebuff --local codebuff --branch main --file README.md --must-contain '[our evals](evals/README.md)' --search 'evals/README.md in:title,body' passed, confirming the bug marker is still on upstream/main and no open duplicate PR exists.\n\n## Notes / Risks\n\nNo code changes. Only the README link is updated, so there is no risk to runtime behavior. The PR title and commit follow the repo's existing docs(scope): ... convention.

Problem: README.md links to evals/README.md, which does not exist.

Fix: point the 'our evals' link to evals/buffbench/README.md, the existing evaluation documentation.

Verification: confirmed with a local markdown link scan that only the evals/README.md link is broken, and 'ls -l evals/buffbench/README.md' confirms the target exists.
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