Systems reviewed

General Comments


Responses to Colin's suggested criteria:

Easy to maintain and update

Current and up to date

Support users who don't adopt the latest release right away

Foster contribution to the documentation

Other Comments

Full Language Support

The implications for this are:

Comment Structure




General Impressions

I tried generating the docs for our code using all three of these systems, starting with no modifications to the comments, then experimenting with adding comments to some functions.

First thought: I suspect that our judicious care in namespacing, scoping, etc. confuses these systems.