Update schema.md with API overview and remove 'score' details

[tamir-cow]

Added an overview of the API for the solve engine and removed detailed explanation of the 'score' key.

Summary by CodeRabbit

Documentation

• Updated API schema documentation with improved organization and clarity
• Removed deprecated score-related reference sections
• Added introductory guidance to provide better context for API schema overview

_{✏️ Tip: You can customize this high-level summary in your review settings.}

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Preview	Updated (UTC)
docs	Ready	Preview	Dec 1, 2025 8:20am

[coderabbitai]

Walkthrough

The documentation for the CoW Protocol auction schema was updated to remove the score section from Solutions output and add an introductory statement clarifying the Schemas section's purpose.

Changes

Cohort / File(s)	Summary
Documentation Update docs/cow-protocol/reference/core/auctions/schema.md	Removed the score section (including kind, score, and successProbability fields) from Solutions output documentation; added introductory sentence explaining the section's purpose.

Estimated code review effort

🎯 1 (Trivial) | ⏱️ ~3 minutes

Poem

📚 A rabbit hops through docs with glee,
Clearing clutter, keeping schema spree,
Score be gone, the path now clear,
Purpose stated, crisp and near! 🐰✨

Pre-merge checks and finishing touches

❌ Failed checks (1 warning)

Check name	Status	Explanation	Resolution
Description check	⚠️ Warning	The description is incomplete. It lacks the required 'Changes' section with detailed, actionable steps and missing checkbox items as specified in the template.	Add a 'Changes' section with bullet points describing each modification, including checkboxes and specific details about what was added and removed.

✅ Passed checks (2 passed)

Check name	Status	Explanation
Title check	✅ Passed	The title clearly summarizes the main changes: adding an API overview and removing score details from the schema documentation.
Docstring Coverage	✅ Passed	No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.

✨ Finishing touches

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Post copyable unit tests in a comment
• Commit unit tests in branch update/schemas-doc

---

📜 Recent review details

Configuration used: CodeRabbit UI

Review profile: CHILL

Plan: Pro

📥 Commits

Reviewing files that changed from the base of the PR and between 4a7bddf and 0f6d68e.

📒 Files selected for processing (1)

• docs/cow-protocol/reference/core/auctions/schema.md (1 hunks)

🔇 Additional comments (2)

docs/cow-protocol/reference/core/auctions/schema.md (2)

7-7: Clear introductory statement added.

The new sentence effectively clarifies the purpose of the Schemas section by providing readers with immediate context about what the section covers.

---

40-40: Verify that remaining score references are still appropriate after removal.

The PR removes the score section, but line 40 still references "evaluating the score of a given solution." Confirm whether this reference should be updated, clarified, or contextualized differently now that the detailed score explanation has been removed.

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands and usage tips.}