For Help Viewer 2.0, it has come to light that links to types in the Syntax section that use the ID style (i.e. links within the Help Viewer collection such as those to types within the documented assembly) no longer work because it doesn't bother updating
their ms-xhelp URL if the link is within a pre element or at least one in that section. This affects all presentation styles. Work item:
Another alternative is to update the syntax components so that they no longer render links for types at all in the Syntax section.
I'm leaning towards just removing the links in the Syntax section for the following reason: Links to the types are currently rendered for parameters in the Parameters section. A link for the return value type is not rendered yet but that
can be added easily enough. Those links effectively negate the need to have them in the Syntax section as well since the types would be accessible via links elsewhere on the page. This appears to be the direction taken on MSDN now and it does make
sense and gets rid of duplicate links.
So, the question is this: If they were removed from the Syntax section would anyone really miss them considering the type information links would be available elsewhere on the page?
Unless there are compelling arguments for keeping them, I'll look at removing them at some point in the future from the syntax generation components and adding a type link for the return value in all presentation styles. Reply here with any relevant