It’s been two days since I announced docu, my simple documentation generator for .Net apps.
The reception it’s received has been positive, I never expected it to have a surge of popularity because it’s not that kind of tool, so it hasn’t come as much of a surprise that people haven’t been jumping all over it. Having said that though, I have had some good feedback and already someone has contributed a patch. Additionally, there hasn’t been one question as to why I’ve created it; now this has come as a surprise, I guess I’m not the only one that feels Sandcastle is bloated and overcomplicated. Yay!
I’ve just pushed out some changes to the github repos and released an updated alpha (v0.1.0.2) on the downloads page. The biggest changes so far are the inclusion of events and fields in the parsing, which now means docu has <summary /> support for all documentable members. The rest of the changes are mainly refactorings and some battle-hardening.
I’ve got some more changes and several issues lined up, so keep an eye out.
Comments...
Here’s a question for you, do you have an MSBuild task for it also?
By Justin Chase — 3 Mar, 2009 @ 2:08 pm
Not currently, but it’s something I’d consider for the future. That being said, it’s pretty straight forward to call it from an exec task (or whatever they’re called in MSBuild).
By James Gregory — 3 Mar, 2009 @ 2:10 pm
Might want to read over this discussion of Docu:
http://groups.google.com/group/nhibernate-development/browse_thread/thread/c7a1977879e50cf0/c7c62eeec63ebeec?lnk=gst&q=docu#c7c62eeec63ebeec
By Will Shaver — 3 Mar, 2009 @ 2:33 pm
Thanks for the tip Will, I’ll be sure to try to improve Docu based on this feedback.
By James Gregory — 3 Mar, 2009 @ 5:10 pm
I’ve just tried it and I like what I see! There really seem to be no “Just run”-Xmldoc tools, with Sandcastle being unneccesary complex for what should be a simple task.
Docu just works so far. I don’t like the default template, but using Spark was a smart choice.
By Michael Stum — 6 Jun, 2009 @ 2:55 pm
Post a comment...