Regenerate Sql, AzureAD and Mq with documentation version affixes aligned

[daviburg]

Description

Regenerates Sql, AzureAD and Mq from AzureUX-BPM PR 16648499, which aligns generated documentation with the identifiers it documents.

Version affixes are stripped from identifiers but survived in the human-readable text derived from the swagger summary and description, so SqlExtensions emitted public class GetTablesResponse documented as Response for Get tables (V2) — the identifier and its own documentation disagreed.

Documentation-comment only. All 94 changed lines are doc comments. No identifier, signature or wire change.

Demonstrating set

These three clients were chosen to exercise all three behaviours of the fix, not to be exhaustive:

Client	Affixed doc lines	Demonstrates
Sql	28 → 2	The motivating example
Mq	17 → 0	Lowercase (v2), matched case-insensitively
AzureAD	5 → 1	Both the strip and the keep case

AzureAD is the interesting one. Four affixes are dropped because the identifier was simplified. The one that remains documents GetMemberGroupsResponseV2, which kept its affix — so its summary has to keep it too, or it reads identically to its sibling and callers cannot tell the two response types apart. That is the case that rules out simply stripping every affix.

Sql was originally held out of this PR: regenerating it also pulled in the Purview identifier correction that was in flight as #227, which would have put the same change in two open PRs. #227 has since merged, so Sql now regenerates clean and is included.

Catalogue-wide the generator fix takes 384 affixed doc lines down to 45 across shipped clients; the remaining 45 are all deliberate (28 verbatim trigger citations, 15 mid-sentence, 2 identifiers that kept their affix). The other affected clients settle in the planned full sweep rather than inflating this PR.

Testing

• Unit tests added/updated

• All existing tests pass (dotnet test)

• Manual testing (describe below if applicable)

• dotnet build: 0 errors, 0 warnings.

• 935 tests pass, 0 failures.

• Generated from the BPM branch at commit 7201f4d039 with --directClient --connectors=sql,azuread,mq against the pinned 1596-entry ARM cache.

• Verified mechanically that every changed line is a doc comment, so this cannot alter behaviour.

• Rebased onto main at 6f75cd4 after Regenerate Sql and AzureBlob with the corrected Purview parameter name #227 merged.

No unit tests added: this PR contains only generated output. The generator behaviour is covered by 8 new tests in the paired BPM PR, verified non-vacuous by neutralizing the match pattern.

Checklist

• Code follows the project's coding conventions
• No modifications to files under src/**/Generated/ (see CONTRIBUTING.md)
• Documentation updated (if behavior changed)
• CHANGELOG.md updated (if user-facing change)
• release_notes.md updated (if shipping a new version, clear previous version notes)
• Version updated in eng/build/Version.props (if shipping a new version)

The Generated/ checkbox is intentionally left unchecked: this is a generator-driven regeneration, the sanctioned way those files change. No file was hand-edited.

CHANGELOG.md is intentionally not updated — this changes documentation comments only, with no effect on the compiled API surface or on callers.

Depends on AzureUX-BPM PR 16648499 merging first.

Authored with Dobby agent.

[Copilot]

Copilot wasn't able to review any files in this pull request.

[Copilot]

Copilot wasn't able to review any files in this pull request.

[daviburg]

/azp run

[azure-pipelines]

Azure Pipelines:
Successfully started running 1 pipeline(s).