NuGet / NuGetGallery

NuGet Gallery is a package repository that powers https://www.nuget.org. Use this repo for reporting NuGet.org issues.
https://www.nuget.org/
Apache License 2.0
1.52k stars 643 forks source link

[Feature]: Provide an API reference explorer for packages using the generated .xml files inside a package #9776

Open hach-que opened 6 months ago

hach-que commented 6 months ago

Related Problem

No response

The Elevator Pitch

Having README.md files within packages is great, and helps provide an introduction on how to use a package. But for more complex packages, and packages where they're already extensively documented through the /// <summary> syntax in C#, it'd be great if NuGet could provide an "Explore API" or "API Reference" tab which lists all of the types and methods along with their summaries and parameters, based on all of the .xml files within the package. This would mean that package developers don't have to duplicate reference material into the README.md, when it's already present in the package.

An extra bonus would be some sort of link syntax in the README.md that can link to types and methods in the API Reference tab, like [ISomeInterface](#api-explorer-ISomeInterface).

Additional Context and Details

No response