Skip to content
/ XDG Public

Xml Documentation Generator for .NET languages (C#, VB.NET etc)

License

Notifications You must be signed in to change notification settings

seaeagle1/XDG

Repository files navigation

Table of Contents

XDG: Xml Documentation Generator

https://github.com/seaeagle1/XDG

What is it?

XDG is a tool for converting Xml documentation comments from .NET languages like C# and VB.NET into readable web-based API documentation. It is essentially a very simple replacement for more complex and advanced tools like Sandcastle and Monodoc.

How does it work?

XDG uses Mono.Cecil to reflect a .NET assembly and gather all classes, methods, properties etc. Optionally you can also add the Xml documentation file containing all the documentation comments, XDG will then search that file and add your comments to the type information.

When all this information is gathered, XDG writes out JSON files containing all the information needed to build a documentation page. This JSON object can then be imported in a Javascript, PHP or other scripted template to be displayed in any way you like. Currently we have a pure Javascript/HTML example template using the PURE template system.

How do I use it?

Currently XDG is still very much in its infancy… if you can’t figure it out from the code, you probably shouldn’t use it just yet.

What license does it have?

XDG itself is available under the Mozilla Public License v2.

It also makes use of XmlDocIdLib (CodeProject Open License) and Mono.Cecil (MIT license).

About

Xml Documentation Generator for .NET languages (C#, VB.NET etc)

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published