Fix API docs

[mdaigle]

Updates XML documentation comments and references throughout the codebase and documentation to improve accuracy and maintainability. It also makes some minor behavioral clarifications.

[Copilot]

Pull request overview

This PR improves the correctness of generated XML API documentation by fixing <include> snippet paths across several source files, correcting generic type/member references in snippet XML, and enabling XML doc generation for the main Microsoft.Data.SqlClient project.

Changes:

• Fix relative <include file='...'> paths in several src/ files so snippet XML is resolved correctly during doc generation.
• Update snippet XML references (notably for generic SqlVector<T> and generic retry logic method xrefs) and clarify SqlDataAdapter event documentation.
• Enable XML documentation file generation in Microsoft.Data.SqlClient.csproj.

Reviewed changes

Copilot reviewed 9 out of 9 changed files in this pull request and generated no comments.

Show a summary per file

File	Description
src/Microsoft.Data.SqlClient/src/Microsoft/Data/SqlTypes/SqlVector.cs	Fix <include> paths (and remove BOM) so SqlVector<T> docs pull from the correct snippet file.
src/Microsoft.Data.SqlClient/src/Microsoft/Data/SqlTypes/SqlJson.cs	Fix <include> paths so SqlJson docs pull from the correct snippet file.
src/Microsoft.Data.SqlClient/src/Microsoft/Data/SqlDbTypeExtensions.cs	Fix <include> paths to the correct Microsoft.Data snippet location.
src/Microsoft.Data.SqlClient/src/Microsoft/Data/SqlClient/SqlDataReader.cs	Fix <include> paths for GetSqlJson / GetSqlVector documentation.
src/Microsoft.Data.SqlClient/src/Microsoft.Data.SqlClient.csproj	Enable GenerateDocumentationFile for the main project.
doc/snippets/Microsoft.Data.SqlClient/SqlDataReader.xml	Correct SqlVector<T> cref usage to generic-arity form.
doc/snippets/Microsoft.Data.SqlClient/SqlDataAdapter.xml	Clarify RowUpdating/RowUpdated behavior and fix event references + sample query spacing.
doc/snippets/Microsoft.Data.SqlClient/SqlCommand.xml	Fix generic-method xref syntax and correct vector-type xref arity.
.github/prompts/ado-work-item-clarification.prompt.md	Update prompt guidance to always query the ADO.Net project for work items.

---

You can also share your feedback on Copilot code review. Take the survey.

[codecov]

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 68.16%. Comparing base (00b77cd) to head (7d83aff).
⚠️ Report is 5 commits behind head on main.

❗ There is a different number of reports uploaded between BASE (00b77cd) and HEAD (7d83aff). Click for more details.

HEAD has 2 uploads less than BASE

Flag	BASE (00b77cd)	HEAD (7d83aff)
CI-SqlClient	2	0

Additional details and impacted files

@@            Coverage Diff             @@
##             main    #4065      +/-   ##
==========================================
- Coverage   75.42%   68.16%   -7.26%     
==========================================
  Files         280      275       -5     
  Lines       43834    66924   +23090     
==========================================
+ Hits        33060    45621   +12561     
- Misses      10774    21303   +10529     

Flag	Coverage Δ
CI-SqlClient	?
PR-SqlClient-Project	68.16% <ø> (?)

Flags with carried forward coverage won't be shown. Click here to find out more.

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:

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

[paulmedynski]

One question.

[paulmedynski]

Why did this change from %2A to %601, but not the one on line 3607 above? I'm guessing it's actually %60 (backtick) followed by 1, but that's pretty nasty if so. Can we not use backtick characters in XML?