I have followed the steps at MSDN, and other SO questions, to setup documenting and to have the XML comments show in the descriptions section of the help page. However, I am
I know this answer comes very late, but I ran into the same problem. I could not get Visual Studio 2017 to output the XML Documentation file to the suggested ~/App_Data/XmlDocument.xml
location.
However, I found that the correct file is generated under ~/bin/
. So if your project is "TestWebAPI2", then this file should be ~/bin/TestWebAPI2.xml
.
(I couldn't see if there was a way to move/copy this file to ~/App_Data
, but I didn't look for a very long time)
To get this working, go to ~/Areas/HelpPage/App_Start/HelpPageConfig.vb and change the following line to suit:
config.SetDocumentationProvider(New XmlDocumentationProvider(HttpContext.Current.Server.MapPath("~/App_Data/XmlDocument.xml")))
becomes
config.SetDocumentationProvider(New XmlDocumentationProvider(HttpContext.Current.Server.MapPath("~/bin/.xml")))
(don't forget to replace
with your WebAPI2 project name)