I think we should have the following guildelines for all of our
projects:

* JavaDocs existing and linked to from the project documentation
* JUnit test results from last release if they exist should be linked to
* Download should map to:

http://jakarta.apache.org/builds/jakarta-avalon/release/${project}/lates
t/

That way the user is sent directly to the latest release available.

* Optional: diagram docs.  They are useful, but unless we have a way to
     generate them from the code, we shouldn't include them.
* Features document listing what is there--unless there are
sub-sub-projects.
  The sub-sub-projects are the features of the sub-projects.
  - In Excalibur/Apps each sub-sub-project (aka datasources, ftp-server)
    are the features.
  - Each sub-sub-project should have a list of features that describe
it.

Let me congratulate Paul on his great work, and see if this can help
all of us out more.


"They that give up essential liberty to obtain a little temporary safety
 deserve neither liberty nor safety."
                - Benjamin Franklin


--
To unsubscribe, e-mail:   <mailto:[EMAIL PROTECTED]>
For additional commands, e-mail: <mailto:[EMAIL PROTECTED]>

Reply via email to