[JDEV] Jabberd 1.5 Development
theo at theoretic.com
Wed Jan 16 18:38:09 CST 2002
On Tue, 2002-01-15 at 14:46, Frédérique Pinson wrote:
> Preceding messages (on errors code, or component architecture for
> exemple) show that there is a demand for such docs and specs.
> That is why I propose you to also enhance the effort on documentation.
> I know that there are many many things to do on Jabber, that
> documenting and specifying are time consuming tasks,
> and that Jabber developpers have only two fingers, one brain et two
> eyes... and like all developpers (from which I am) they prefer coding
> than writing clear specification -- that's already in their head...
> But when you intend to spread your techno over the world -- and want
> people to build their software based upon your techno - please consider
> that documentation would ease their job, thus the adoption of your
> techno. And if they can easily use it -- without having to read your
> code to understand how to do --, the techno will really become a
> standard component of Internet infrastructure.
> Well, I would like to...that's why I wrote you these kindly unpleasant
Yes, I second that. The #2 "fix" in future versions of Jabber should be
the documentation. While alot of the *content* may be on the website, it
is obviously not very well organized, and I'm sure even better content
could be done. This is only after the #1 fix of bug-killing, and well
before the #3 fix of adding features like the recent POP3 Offline
I personally love writing documentation. I am not a coder (I hate
coding), and am more of an ideas researcher and designer. I am working
on a good newbie introduction to Jabber to replace StPeter's good but
outdated one. I'll be contributing it in a month or so. But, if the JSF
is able to hire me, I wouldn't mind doing documentation all day long :-)
Ohh, yeah, Jabber would be the best documented technology out there..
/\ Adam Theo, Age 22, Tallahassee FL USA
//\\ Email & Jabber: theo at theoretic.com
// \\ MSN: theo at theoretic.com YIM: adamtheo2
=//====\\= (Boycotting AOL, therefore no AIM or ICQ)
// || \\ Theoretic Solutions: http://www.theoretic.com
|| "Bringing Ideas Together"
|| Jabber Protocol: http://www.jabber.org
|| "The Coolest IM on the Planet"
|| "A Free-Market Socialist Patriotic American Buddhist"
More information about the JDev