Remove commented xref for endpoint specific operation transformers

[sander1095]

Note: Should this PR also include removing this comment:

https://github.com/dotnet/AspNetCore.Docs/blob/a7b09b2cca9f23d241350ac0b3d8917aa3b6904e/aspnetcore/fundamentals/openapi/customize-openapi.md?plain=1#L105C1-L111C114

I can also make this a separate PR :)

@wadepickett

Sure it can be the same PR, thanks!

Originally posted by @wadepickett in #36330 (comment)

---

Associated WorkItem - 509040

[sander1095]

Hi @wadepickett . I wont have time the next few days to do this one. Please assign it to someone else. Thanks! 😊

[wadepickett]

You were a fantastic help! Thanks @sander1095!!!

[wadepickett]

Testing issue analysis and action plan copilot instructions...

[wadepickett]

AI Analysis Report

Analyzed by: @wadepickett
Date: 2025-11-14
Issue: #36331
Model: GitHub Copilot

Issue Analysis: Remove commented xref for endpoint specific operation transformers

✅ Issue Validation

Status: Valid and actionable

📋 Issue Summary

The issue requests removal of a commented-out <xref> reference related to endpoint-specific operation transformers in the ASP.NET Core OpenAPI customization documentation. The commented code appears outdated or unnecessary, and its removal would clean up the documentation. The request specifically references lines 105–111 of customize-openapi.md.

📁 Affected Files

File	Path	Lines	Section
Main article	aspnetcore/fundamentals/openapi/customize-openapi.md	105-111	"Use operation transformers"

📝 Proposed Changes

Documentation Updates

File: customize-openapi.md
Location: Lines 105-111, preceding the paragraph explaining the use of AddOpenApiOperationTransformer.

Current content (lines 105-107):

<!-- UPDATE 10.0 - API doc cross-link:
                   <xref:Microsoft.AspNetCore.Http.OpenApiRouteHandlerBuilderExtensions.AddOpenApiOperationTransformer%2A>
-->

Proposed change:

1. Remove the above commented block entirely; it serves no purpose in published documentation.

2. Leave narrative line about AddOpenApiOperationTransformer unchanged, as it is correct and aligns with current best practices and .NET 10+ documentation.

🎯 Action Plan

1. Edit file: aspnetcore/fundamentals/openapi/customize-openapi.md
   • Navigate to: Lines 105-111
   • Remove: The commented-out <xref> block pertaining to AddOpenApiOperationTransformer.

⚠️ Considerations

• Verify that removal does not affect any automated docs generation (unlikely due to comment block format).
• Check if similar commented cross-link references exist elsewhere in docs and flag for cleanup.
• This change applies to .NET 10.0+ documentation context.

🔗 References

• Published article: Customize OpenAPI documents
• Issue #36331
• Originating issue comment