none
XML Documentation Customization in VS 2015

    Question

  • I am wondering if there is a way to customize the XML documentation tags accessible in VB.Net by typing ‘’’.  I was able to find numerous references on how to accomplish this in previous versions of Visual Studio, but was unable to find a working method for Visual Studio 2015.  Further, I was unable to find a definitive answer on whether the previous methods have been deprecated in the latest version.  As the ability to accomplish this would significantly improve everything from productivity to functionality, I would sincerely appreciate an “official” response from Microsoft!  Thank you very much in advance for any help or insight you could provide.
    Wednesday, June 15, 2016 5:17 PM

Answers

All replies

  • Hi lokeysan,

    >> I was able to find numerous references on how to accomplish this in previous versions of Visual Studio, but was unable to find a working method for Visual Studio 2015. 

    Could you share us the references or documents you got about the old VS before? So we could understand this issue better.

    Best Regards,

    Jack


    We are trying to better understand customer views on social support experience, so your participation in this interview project would be greatly appreciated if you have time. Thanks for helping make community forums a great place.
    Click HERE to participate the survey.

    Monday, June 20, 2016 3:30 AM
    Moderator
  • Hi Jack,

    Thanks for the reply.  The following link is representative of the examples I was able to find:

    https://blogs.msdn.microsoft.com/lisa/2010/05/24/how-to-customize-the-xml-comments-that-are-inserted-by-the-visual-basic-code-editor/
    I've tried this method, and it doesn't seem to work with VS 2015. Let me know if I can provide any more info! I hope we can figure this out!

    Monday, June 20, 2016 4:54 PM
  • Hi lokeysan,

    Do you test it in old VS2013 version?

    It seems that other members also met the similar issue before:

    https://social.msdn.microsoft.com/Forums/vstudio/en-US/13b66f08-077e-4f88-811e-e4ad8efe9ccb/are-xml-comments-in-vb-still-customizable?forum=visualstudiogeneral

    One community member shared us some suggestions, could you check it in your side?

    Best Regards,

    Jack


    We are trying to better understand customer views on social support experience, so your participation in this interview project would be greatly appreciated if you have time. Thanks for helping make community forums a great place.
    Click HERE to participate the survey.

    Wednesday, June 22, 2016 9:09 AM
    Moderator
  • Good morning Jack!

    I have not tested this in any previous versions of Visual Studio.  Prior to the project I am working on now, I had no need to customize the tags that are auto generated.  I am able to manually add custom tags to the source code, and they do appear in the output file, however, this is somewhat cumbersome and prone to errors as there are numerous engineers,  spread across a wide geographical area, working on this project.  The project involves the automation of customized tests designed to verify/validate various avionics products.  The XML output file is consumed by the automation framework to provide detailed information about the commands made available to the end users.  I am assuming from the articles that I've read that customization was at one time available in previous versions of Visual Studio.  I see from the comments on the reference I linked above that many users are experiencing the same issue as I am, but there seems to be no "official" Microsoft acknowledgement that this feature has been deprecated, or if another method of accomplishing the same feat is available.

    Wednesday, June 22, 2016 2:41 PM
  • Hi lokeysan,

    Like this blog provided by you here:

    https://blogs.msdn.microsoft.com/lisa/2010/05/24/how-to-customize-the-xml-comments-that-are-inserted-by-the-visual-basic-code-editor/

    I test it in my VS2013 and VS2015 machine.

    For example, create and edit the .xml file, copy it to the folder C:\Users\user\AppData\Roaming\Microsoft\VisualStudio\12.0/14.0, and then restart the VS, it doesn't work in my side.

    To get the issue confirmed and diagnose by product team, would you please create connect report for it? You will get email notification for update.http://connect.microsoft.com/VisualStudio/feedback/CreateFeedback.aspx

    In addition, maybe certain extension tool from the gallery site would be helpful for you:

    https://visualstudiogallery.msdn.microsoft.com/46A20578-F0D5-4B1E-B55D-F001A6345748

    Best Regards,

    Jack


    We are trying to better understand customer views on social support experience, so your participation in this interview project would be greatly appreciated if you have time. Thanks for helping make community forums a great place.
    Click HERE to participate the survey.

    Friday, June 24, 2016 8:25 AM
    Moderator
  • Jack,

    I followed the directions you sent, and created a connect report.  I have not heard back at all from them, but it said that I should receive an email when a response is given.  I suppose that your above reply is the answer, but I still don't feel like I have any closure on this issue.

    Tuesday, June 28, 2016 2:38 AM
  • Hi lokeysan,

    https://connect.microsoft.com/VisualStudio/Feedback/Details/2854064

    As you already submit one feedback on the Microsoft Connect site, let's focus on the case on that channel, may the senior members can provide more professional support.

    Best Regards,

    Jack


    We are trying to better understand customer views on social support experience, so your participation in this interview project would be greatly appreciated if you have time. Thanks for helping make community forums a great place.
    Click HERE to participate the survey.

    Tuesday, June 28, 2016 9:13 AM
    Moderator