For an overview of what VbaGit is, please read Integrate VBA with Github. If you are working with Google Apps Script as well as VBA, then you will probably be familiar with JDSOC. This is a way of documenting your code in order to generate automatic documentation.

Some of what JSDOC does is already done by the automatic documentation feature in VbaGit (example). I figured it would be nice if VbaGit could enhance that by understanding a subset of JSDOC. That means that you can copy documentation for functions between VBA and Apps Script versions of things without having to rewrite them. VbaGit will take JSDOC syntax and build it into the markdown documentation it creates – see the example below of the docs generated for a procedure.
The argument and return types are detected from analyzing the code, but the description of the procedure and its arguments are taken from any JSDOC type comments that VbaGit finds in the code.

In JavaScript, the above would be documented like this

Of course this is not valid syntax in VBA, but all we have to do is comment out the block, and leave it in the code just before the procedure to which it applies. The @return and {..type..} constructs are ignored by VbaGit since it can accurately get those from the code analysis, but you can leave them in if you like, or miss out the @return and leave the type construct as {}, so this will work equally well

and that’s it!

Now take a look below for more on this subject

For help and more information join our community, follow the blog or follow me on Twitter.
For how to do this for Google Apps Script, see Getting your apps scripts to Github