Skip to content

docs: rebuild README as a judge-first, evidence-backed landing page - #71

Merged
Pavithran-R-A merged 3 commits into
mainfrom
docs/hackathon-readme-final-20261108
Nov 8, 2026
Merged

Pavithran-R-A merged 3 commits into
mainfrom
docs/hackathon-readme-final-20261108

Conversation

@Pavithran-R-A

Copy link
Copy Markdown
Owner

Goal

Turn MergeSutra's 2,192-line, implementation-diary-style README into a crisp, evidence-backed landing page for BharatCode Build League judges, developers and maintainers.

Result

  • 167-line product page (down from 2,192) with the hook AI can propose a fix. MergeSutra demands evidence.
  • Demonstration and a judge's guide accessible immediately.
  • Problem → solution → what makes it different → evidence → install → safety boundaries.
  • Honest disclosure that the demo uses a scripted gateway, the older live-Qwen run is historical, current-head live E2E and ten-case benchmark are still missing, and IDE integration is not shipped.
  • Direct calls to action for authentic feedback, votes and stars; no artificial engagement.
  • All model/configuration variables, OS matrix claims and package-safe README pointers preserved.

Tests / review constraints

  • Keep tests/security/promise-vocabulary.test.ts green (README opening promise measured at 645 characters; allowed 800).
  • Preserve tests/config/config-docs.test.ts, tests/docs/platform-matrix.test.ts, tests/security/shipped-pointer-boundary.test.ts, package and artifact tests.
  • Require all 6 CI matrix jobs + 8 scripted customer journeys.
  • No code, runtime, security policy, API key, model spending or remote publication modifications.

Relevant baseline

main at c6fd87102d24977b255bc4bbb7fb2a3e1c2cf24e, with 6/6 green CI: https://github.com/Pavithran-R-A/mergesutra/actions/runs/42492506208.

This PR does not itself prove the present SHA's live BharatCode issue-to-PR execution.

Copilot AI balanced review requested due to automatic review settings November 8, 2026 15:21

Copilot AI left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Copilot wasn't able to review any files in this pull request. Copilot's per-file or total diff limits were exceeded. Try reducing the changed content or splitting the changes into smaller pull requests, then request a review from Copilot again.

@Pavithran-R-A
Pavithran-R-A merged commit 801aab0 into main Nov 8, 2026
7 checks passed
@linear-code

linear-code Bot commented Nov 8, 2026

Copy link
Copy Markdown

PAV-162

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.

2 participants