dotnet / dotnet/docfx

[Bug] Template bug

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

Description

**Describe the bug**
When the `separatePages` is used for .NET api docs, the pages for fields have the `` contents also copied over as if the `` in the .NET docs was populated. However, any links in it are not copied over (ex CREFs), replacing the contents with an empty string. This does not happen if `` was explicitly set in the .net xml docs.

When the `samePage` setting is used, the `` contents are not displayed in the `` space at all. If the `` is omitted from the XML docs, then the generated site displays nothing under the field value. The behavious between `samePage` and `separatePages` is inconsistent.

- When `separatePages` is used and `` is not set:ImageImage
- When `separatePages` is used and `` is set:ImageImage
- `samePage` is used, `` unset:ImageImage
- `samePage`, `` set:ImageImage

- Browser: firefox
- Form factor: desktop
- Docfx version: 2.78.3+850a61c2ecb83b0bda21448f1393e480934556fd
- Template: default

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.