[JDEV] MIU, was: MSN transport questions

Matthias Wimmer m at tthias.net
Fri Sep 5 02:49:27 CDT 2003


Hi Robert!

Robert Norris schrieb am 2003-09-05 10:54:04:
> Of course I agree that documentation within jabberd2 has been a problem,
> and that real API docs would be a good thing. The problem I've had is a
> severe lack of time - its taken 18 months to get the server to beta, and
> thats without writing docs - how much longer would it take if I had?

To my own experience it does not take very much time to write doxygen
comments while you are coding. Often you write the same comment that
could be used but do not mark it as a doxygen comment and therefore it
can not be used to generated an extraction of code comments.

> If people want it, then I'll start writing some. But unless its obvious
> to me that it will result in code being contributed, I'm reluctant to
> spend large amounts of potential coding time on it.

It meight be good to just start writing comments, better partially
commented code than uncommented code, I think ;)

But it is something you have to do and something you want to do. It's
also better to have uncommented code than to have no code. And I am
really looking forward to be able to use jabberd2. Thanks for your work.


Tot kijk
    Matthias
-------------- next part --------------
A non-text attachment was scrubbed...
Name: not available
Type: application/pgp-signature
Size: 189 bytes
Desc: not available
URL: <http://mail.jabber.org/pipermail/jdev/attachments/20030905/4d643868/attachment-0002.pgp>


More information about the JDev mailing list