A Visual Studio extension for generating C# documentation comments
At this time, boilerplate summary documentation comments are added to public, protected, and internal class declarations when the Tools->Invoke GenerateDocumentationCommentsInEditor menu item is selected. Summary documentation is also added to public, protected, and internal class constructors.
I blog about this extension. See the following posts for information about this extension:
- I Was Doing It All Wrong, And How I Changed To Doing It Right! defines an initial set of user stories and a set of 9 unit tests for adding summary documentation comments for class declarations.
- Creating A Documentation Comment Generator For C#: High-Level Design Decisions discusses various ways of triggering the generation of boilerplate documentation comments, and why I chose to create this as a Visual Studio extension.
- Creating A Documentation Comment Generator For C#: Setting Up The Framework looks at creating a Visual Studio extension with a menu item that will generate documentation comments for the active document (the document in the active editor window). It shows how to retrieve the source code in the active document, at a high level how to modify the source code to add documentation comments, and finally, how to write the modified source code back to the active document.
- Creating A Documentation Comment Generator For C#: DocumentCommentsRewriter Class discusses how each syntax node is processed for documentation comment generation, and how that translates into the structure of the class that generates that output.
- Creating A Documentation Comment Generator For C#: Unit Testing begins the discussion of testing of the documentation comments generator by looking at the four levels of testing and then discussing unit testing in some detail.
- Creating A Documentation Comment Generator For C#: Integration, System, And Acceptance Testing discusses integration, system, and acceptance testing that I will perform.
Future posts will be used to extend the discussion.
- Visual Studio 2017, with at a minimum, the following workloads:
- .Net desktop development
- Visual Studio extension development
- .Net Compiler Platform SDK extension
- DGML editor if you want to activate the View Directed Syntax Graph menu item in the Syntax Visualizer. See the Syntax Visualizer section of the Tools For Viewing And Creating Roslyn Syntax Trees post.