Add Documentation DO/DON'T section in agents.md

[suri-kumkaran]

Adds a Documentation DO/DON'T section to agents.md alongside the existing Test Patterns block.

Surfaced during review of #1027 and other PRs, where module- and item-level docs drifted toward manually-maintained type listings and signature restatements. New section captures the "less is more" framing, reminds agents not to duplicate what rustdoc already provides, and codifies the three patterns the reviewer called out as noise.

[Copilot]

Pull request overview

Adds contributor guidance to keep Rust documentation focused on durable semantics rather than duplicating rustdoc output, helping prevent module/item docs from drifting into manually maintained type/signature listings.

Changes:

• Adds a new “Documentation” DO/DON’T section to agents.md.
• Encourages using cargo doc --no-deps to rely on rustdoc-generated structure (signatures, listings, re-exports, links).
• Codifies specific anti-patterns to avoid (manual type/function lists, signature restatements, unnecessary docs for internal visibility items).

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

[codecov-commenter]

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 89.46%. Comparing base (e3139b4) to head (2e6d055).
⚠️ Report is 5 commits behind head on main.

Additional details and impacted files

@@            Coverage Diff             @@
##             main    #1103      +/-   ##
==========================================
- Coverage   89.49%   89.46%   -0.03%     
==========================================
  Files         479      482       +3     
  Lines       90337    91092     +755     
==========================================
+ Hits        80844    81497     +653     
- Misses       9493     9595     +102     

Flag	Coverage Δ
miri	89.46% <ø> (-0.03%)	⬇️
unittests	89.11% <ø> (-0.03%)	⬇️

Flags with carried forward coverage won't be shown. Click here to find out more.
see 15 files with indirect coverage changes

🚀 New features to boost your workflow:

• ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.