dotnet / dotnet/docfx

Inline <seealso> not populating "See Also" section

Open
#1,850 5 comments 4 reactions 0 assignees View on GitHub
dotnet
Dominant language
C#
Stars
4.4k
Forks
890
Avg merge
2h 11m
Merged PRs (30d)
10

Description

### Inline `` does not populate the "See Also" section

### Functional impact

The reference won't appear in the "See Also" section.

### Minimal repro steps

Using docfx v2.20:

```C#
public class PopulatesSeeAlso
{ }

public class DoesNotPopulateSeeAlso
{ }

///
/// Also see .
///
///
public sealed class Test
{ }
```

### Expected result

All `` tags should appear in the "See Also" section, even if they are located inside a top-level tag, such as ``.

### Actual result

A top-level `` tag works as expected, but a `` tag appearing inside e.g. a `` tag will only appear in the "Summary" section, it won't (by itself) create a "See Also" section and it won't appear in the "See Also" section.

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.