{"action":"created","issue":{"url":"https://api.github.com/repos/EWSoftware/SHFB/issues/250","repository_url":"https://api.github.com/repos/EWSoftware/SHFB","labels_url":"https://api.github.com/repos/EWSoftware/SHFB/issues/250/labels{/name}","comments_url":"https://api.github.com/repos/EWSoftware/SHFB/issues/250/comments","events_url":"https://api.github.com/repos/EWSoftware/SHFB/issues/250/events","html_url":"https://github.com/EWSoftware/SHFB/issues/250","id":131753013,"number":250,"title":"How to add hyperlinks to non-MSDN Microsoft Types using Visual Studio 2015 SHFB project ","user":{"login":"dkemlage","id":5495810,"avatar_url":"https://avatars.githubusercontent.com/u/5495810?v=3","gravatar_id":"","url":"https://api.github.com/users/dkemlage","html_url":"https://github.com/dkemlage","followers_url":"https://api.github.com/users/dkemlage/followers","following_url":"https://api.github.com/users/dkemlage/following{/other_user}","gists_url":"https://api.github.com/users/dkemlage/gists{/gist_id}","starred_url":"https://api.github.com/users/dkemlage/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/dkemlage/subscriptions","organizations_url":"https://api.github.com/users/dkemlage/orgs","repos_url":"https://api.github.com/users/dkemlage/repos","events_url":"https://api.github.com/users/dkemlage/events{/privacy}","received_events_url":"https://api.github.com/users/dkemlage/received_events","type":"User","site_admin":false},"labels":[],"state":"open","locked":false,"assignee":null,"milestone":null,"comments":1,"created_at":"2016-02-05T20:56:51Z","updated_at":"2016-02-05T21:02:22Z","closed_at":null,"body":"Hello Eric,\r\n\r\nI am using Visual Studio 2015 w/update 1 and the SandCastle Help File Builder version 2015.10.10.0 tools to generate Library Reference API pages.\r\n\r\nI need to generate API docs that are based upon both .Microsoft NET Framework Assemblies and Xamarin Assemblies. I have been able to successfully build the API pages. Now, I am doing the fine tuning and it is desired to have hyperlinks appear in the SandCastle generated API pages that link to the Xamarin Types on their web site. Currently, any Xamarin Types that are encountered are just **BOLDED** and there is no hyperlink to their Types like those that are automatically generated for Microsoft MSDN Types.\r\n\r\nTo build the API docs, I add the required Xamarin .NET based .dlls into the SandCastle project as 'Documentation Sources'. Then, I go into the VS Project menu > [SandCastleProjectName] Properties menu item > Visibility tab > Edit API Filter button and turn off all the Namespaces except for the Assembly that we build and need to document. <-- I realize that I could have just added the dependency .dlls as Refeences but you get more control by being able to turn off specific things - but I digress...\r\n\r\nDoes the SHFB have some mechanism built in (Component, Plug-In, or other means) where you supply a table/XML file/etc. that contains (1) a non-MSDN Types and (2) their corresponding web hyperlink, so that these hyperlinks can get generated as part of the build process? \r\n\r\nI was thinking of a table something like:\r\n\r\nTYPE,HYPERLINK\r\n\"View\",\"https://developer.xamarin.com/api/type/Xamarin.Forms.View/\"\r\n\"VisualElement\",\"https://developer.xamarin.com/api/type/Xamarin.Forms.VisualElement/\"\r\n\"Element\",\"https://developer.xamarin.com/api/type/Xamarin.Forms.Element/\" \r\n\"BindableObject\",\"https://developer.xamarin.com/api/type/Xamarin.Forms.BindableObject/\"\r\n\r\nHere is a visual representation of the problem we are facing:\r\n![linkstononmicrosofttypes](https://cloud.githubusercontent.com/assets/5495810/12858774/fa15271e-cc06-11e5-9f1f-2b0a09808f75.png)\r\n\r\nI tried scouring the SandCastle online documentation (http://ewsoftware.github.io/SHFB/html/bd1ddb51-1c4f-434f-bb1a-ce2135d3a909.htm) but could not figure out how to make this happen.\r\n\r\nThanks for any guidance you could provide.\r\n-Don"},"comment":{"url":"https://api.github.com/repos/EWSoftware/SHFB/issues/comments/180553173","html_url":"https://github.com/EWSoftware/SHFB/issues/250#issuecomment-180553173","issue_url":"https://api.github.com/repos/EWSoftware/SHFB/issues/250","id":180553173,"user":{"login":"EWSoftware","id":10552523,"avatar_url":"https://avatars.githubusercontent.com/u/10552523?v=3","gravatar_id":"","url":"https://api.github.com/users/EWSoftware","html_url":"https://github.com/EWSoftware","followers_url":"https://api.github.com/users/EWSoftware/followers","following_url":"https://api.github.com/users/EWSoftware/following{/other_user}","gists_url":"https://api.github.com/users/EWSoftware/gists{/gist_id}","starred_url":"https://api.github.com/users/EWSoftware/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/EWSoftware/subscriptions","organizations_url":"https://api.github.com/users/EWSoftware/orgs","repos_url":"https://api.github.com/users/EWSoftware/repos","events_url":"https://api.github.com/users/EWSoftware/events{/privacy}","received_events_url":"https://api.github.com/users/EWSoftware/received_events","type":"User","site_admin":false},"created_at":"2016-02-05T21:02:22Z","updated_at":"2016-02-05T21:02:22Z","body":"Only add assemblies/project that you want included in the documentation as documentation sources.  Anything else such as reference assemblies should be left out.  You can only add clickable links for external types that can be found on MSDN.  If the Xamarin types aren't there, you won't be able to do it.\r\n\r\nIf they are, use the [Additional Reference Links] plug-in to generate the necessary information for them.  You'll create a separate SHFB project for the required assemblies and add them to that.  Add that project to the plug-in's configuration and set the link type to MSDN.  That should then allow the build to generate the necessary links to the MSDN content.\r\n\r\nIf they are not on MSDN, you can still use the plug-in but only to suppress the warnings by setting the link type to None.\r\n"}}