dotnet / dotnet-api-docs

.NET API reference documentation (.NET 5+, .NET Core, .NET Framework)
https://docs.microsoft.com/dotnet/api/
Other
708 stars 1.55k forks source link

[Feature request] API Browser containing links to related articles (outside of .NET API Browser) #8621

Open wiktor-golonka opened 1 year ago

wiktor-golonka commented 1 year ago

It would be great if there would be a place on the .NET API Browser article page, containing list of correlated articles from Microsoft Docs which are somehow (maybe even loosely) related to the given .NET API Browser article.

The Recommended Content section that is currently there, seems to always recommend articles from .NET API Browser.

For example, on the .NET API Browser article page about the IdentityBuilder.AddTokenProvider Method: IdentityBuilder.AddTokenProvider Method

These articles could be recommended:

And maybe even links to stackoverflow.

Reasons: It would be very useful for people who are actively looking through the source code to better utilise the existing code and they would like to learn more about a method/class/property and where it can be used.

.NET API Browser is very well positioned in search engines, very often it is a first search result that people see if they did not provide a complete question (for example, due to a vocabulary limitation, or maybe they didn't know yet what question to ask, or due to other reasons).

dotnet-issue-labeler[bot] commented 1 year ago

I couldn't figure out the best area label to add to this issue. If you have write-permissions please help me learn by adding exactly one area label.

gewarren commented 1 year ago

Related to #7451.

Thanks for the feedback. We agree that these links are super useful - it's just finding the time/resources to put all of them in place.