MSDN Online Links

Topics: Developer Forum
Apr 30, 2007 at 12:38 AM
I'd like to suggest a feature. I don't know if it's related only with SHFB or also needs any changes in Sandcastle, but I'll try to post here.

In the Help File section of Project Properties, we can configure the 'SdkLinkType'. The possible values are: 'None', 'Index' and 'MSDN'.
If I choose 'MSDN', during the documentation build, a MSDN web service is called to retrieve the appropriate link to MSDN Library for the types that are defined within the .NET Framework assemblies. The returned links are something like 'http://msdn2.microsoft.com/en-us/e5kfa45b' which redirects to the real page 'http://msdn2.microsoft.com/en-us/library/System.Object.aspx'.

My suggestion is to create another option that create links to MSDN Library in an offline (and faster) way. Instead of invoking the MSDN web service, simply create a link to 'http://msdn2.microsoft.com/library/FullTypeName'. MSDN Library also resolves this kind of friendly URL to the real one. For example, a link to 'http://msdn2.microsoft.com/library/System.Object' takes you to 'http://msdn2.microsoft.com/en-us/library/System.Object.aspx'.

One method works as well as the other, it would be great to have both of them avaliable.
Coordinator
Apr 30, 2007 at 1:37 AM
Please post your request on the MSDN Documentation forum as this relates to the ResolveReferenceLinks component that is part of Sandcastle itself.

Eric