[JDEV] Technical Documentation
temas
temas at box5.net
Fri Mar 31 14:11:54 CST 2000
I 100% agree. I'm horrible about commenting code as I go, because primarily
myself and jer are the only ones acknowledgin to have touched the code, and
we use similar styles. I'm making a concious effort to be better at that,
and I'll beat jer with a cluebat of some sort to get him to do it to =). As
for the overview materials, I hope to have a general overview done in a while.
I'm finishing up some layout for all of the IQ and X stuff so that others can
work on that, then I'll move on to the overview document. After that I think
I will return to work on IQs.
--temas
On Fri, Mar 31, 2000 at 11:53:30AM -0800, Philip Stephens wrote:
> I agree with Kimmo P Hamalainen that the entire project needs some
> documentation to explain the structure of the code and the data
> structures, both for the server and the client libraries.
>
> Right now I can't find documentation on the Module and Service APIs
> for the server, and the documentation for the JabberCOM client API has
> insufficient detail and is presented in Delphi syntax only!
>
> Also, there needs to be thorough overview of Jabber. In all the
> documentation I have seen so far, there hasn't even been a definition of
> a "resource", nor a decent definition of "presence". Some of the basic
> concepts that Jabber has been founded on are simply not well described.
>
> I would love to use Jabber in a project, but without good overviews of
> the system, and good technical docs for the source code, it's going to
> take me too long to figure out how to use and modify Jabber to make it
> worth my while.
>
> I could go on about how developers working on this project should make
> it their business to include copious comments in their source and
> maintain docs on their design, but I won't ;-)
>
> Regards,
> Philip Stephens
>
> _______________________________________________
> jdev mailing list
> jdev at jabber.org
> http://mailman.jabber.org/listinfo/jdev
>
-------------- next part --------------
A non-text attachment was scrubbed...
Name: not available
Type: application/pgp-signature
Size: 232 bytes
Desc: not available
URL: <https://www.jabber.org/jdev/attachments/20000331/23cd78b8/attachment-0002.pgp>
More information about the JDev
mailing list