amlovey / DocPreview.VSIX

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

You can find the extension binaries on the Releases page: https://github.com/oleg-shilo/DocPreview.VSIX/releases

This is a source code and defect tracking repository only. For all binaries please visit the product Visual Studio Marketplace page.

This source code is for the Visual Studio 2017 (VS2017) version of the extension. The VS2015 source code is hosted in a separate repository

Project Description

There are many products that assist with producing the API Documentation from XML code comments within C# source code. Some of these products are open source and some are proprietary but most of them are doing very good job for what they are designed to do.

However most of these products fall short assisting with the actual development of the documentation: editing XML code comments as opposite to the building the final documentation. This is because majority of the tools are concentrating on actual authoring of the final documentation and styling it according one or another Help format.

DocPreview is different. It provides an instantaneous preview of a given single XML comments block for C#, C/C++ and VB.NET syntax. DocPreview assists with validating the user input for being compatible with the documentation authoring tools (e.g. Sandcastle). Thus DocPreview is concentrating purely on efficient editing the documentation comments.

DocPreview deliberately doesn't strongly adhere to any of the API Documentation formats (e.g. HTML Help 1/2, MS Help Viewer, Open XML). Instead it concerns only on the validity of the documentation source (XML) and renders the preview in the custom format loosely based on one of the standard HTML Help formats.

DocPreview is reusing some ported/adjusted bits from ImmDoc.NET (https://immdocnet.codeplex.com/). It is rather an excellent HTML documentation building tool, which is a light weight and lightning fast alternative to Sandcastle. Special thanks to Marek Stoj who is the author of ImmDoc.NET.

Using DocPreview

Using DocPreview is straight forward. Open the preview window from Menu->View->Other Windows. Now if you place the cursor inside of the XML code comments the documentation preview will be rendered when you press the refresh icon/button. Alternatively you can tick the 'Auto refresh' checkbox and the preview will be generated automatically.

DocPreview supports all recommended documentation tags except <include>, which is not a subject of preview.

The below is the screenshot that illustrates the use of DocPreview:

About


Languages

Language:C# 50.9%Language:HTML 35.2%Language:CSS 11.5%Language:XSLT 2.4%