docascode / ECMA2Yaml

Apache License 2.0
9 stars 4 forks source link

Self-closing <see href=""/> tag does not correctly generate hyperlink with @href as text #166

Closed heaths closed 3 years ago

heaths commented 3 years ago

It's valid XML doc comment to author this:

<see href="url"/>

Which should generate (HTML e.g.):

<a href="url">url</a>

This does not appear to be the case, as evident in Azure SDK docs due to inadequate template applied from here.

If there is a #text node, that text should be used instead, i.e.:

<see href="url">text</see>

Should generate (HTML e.g.):

<a href="url">text</a>
TianqiZhang commented 3 years ago

Thank you @heaths for reporting this, it's tracked in AB#228057.