[JDEV] Jabberd 1.5 Development

[Adam Theo]

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
> remarks... 

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
Messaging JEP.

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..
hehe. :-)

-- 
    /\  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"