On Sunday 02 December 2001 07:54 pm, you wrote:
> On Sun, Dec 02, 2001 at 03:46:26PM -0500, Scott Young wrote:
> > It would be good if we could transfer the javadocs into the Wiki page.
>
> I don't think this is a good idea.  The Wiki pages should give an
> overview of what the components (packages and classes) do, if someone
> needs more detail then they can generate the Javadocs themselves or look
> at the source.  Keeping the Wiki in sync with the code would be a
> painful and unnescessary chore.
>
> Ian.

Ill transfer just the class descriptions to Wiki then.  The package pages 
should give a description of the package, and descriptions of all the classes 
in the package.  The links to the pages for the classes could be used for 
developers to talk about the class.  What would be neat though is a script 
that automatically generates the javadocs then puts them in another section 
on the website.  Then they could be linked from Wiki.

_______________________________________________
Devl mailing list
Devl at freenetproject.org
http://lists.freenetproject.org/mailman/listinfo/devl

Reply via email to