dotnet / dotnet/aspnetcore

XML doc generation support should resovle inheritdoc in additional files

Open
#60,466 2 comments 1 reaction 0 assignees View on GitHub
area-minimal area-mvc feature-openapi
Dominant language
C#
Stars
38.4k
Forks
10.9k
Avg merge
2d 5h
Merged PRs (30d)
276

Description

The XML documentation comment support is currently able to handle resolving `` references within the compilation assembly by reusing the logic that is used by Roslyn.

This same functionality isn't currently supported for documentation comments that are resolved directly from XML files. In those cases, we have no semantic model to go off of in order to determine the relationships between types. In those situations, we can come up with something rudimentary that tries to understand inheritance hierarchies based on the documentation ID.

Contributor guide

Open the contributing guide

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.