Question about link rendering

[TiLied]

Hello. I have a question, why xml code like this
<seealso href="https://developer.mozilla.org/en-US/docs/Web/API/AbortController"><em>See also on MDN</em></seealso>
renders like so
<a href="https://developer.mozilla.org/en-US/docs/Web/API/AbortController" target="_blank" rel="noopener noreferrer nofollow" class="external"><em>See also on MDN</em>https://developer.mozilla.org/en-US/docs/Web/API/AbortController</a>

Can it be changed? I couldn't find any documentation on this.

It renders correctly in Visual Studio.

[KalleOlaviNiemitalo]

Looks like a bug in #1157:

docfx/src/Docfx.Dotnet/Resources/XmlCommentTransform.xsl

Lines 28 to 44 in d90b318

	<xsl:template match="see[@href and not(parent::member)]">
	<a>
	<xsl:apply-templates select="@*|node()"/>
	<xsl:if test="not(text())">
	<xsl:value-of select="@href"/>
	</xsl:if>
	</a>
	</xsl:template>
	<xsl:template match="seealso[@href and not(parent::member)]">
	<a>
	<xsl:apply-templates select="@*|node()"/>
	<xsl:if test="not(text())">
	<xsl:value-of select="@href"/>
	</xsl:if>
	</a>
	</xsl:template>

Because your seealso element has no text directly in it (although there is text in the em child element), this template assumes there is nothing visible and outputs the href as content. The template for see has the same problem.

The templates could probably be fixed by replacing test="not(text())" with test="not(node())". Alternatively, test="not(.//text())" would find text within child elements too, but it would still treat <seealso href="http://example.org/"><img src="http://example.org/"/></seealso> as empty.

Until that is fixed, you may be able to work around the bug by adding whitespace before <em> or after </em>.

[TiLied]

Thank you) Workaround worked for me.

[KalleOlaviNiemitalo]

Filed the bug as #8965.