incubator-cvs mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From Apache Wiki <wikidi...@apache.org>
Subject [Incubator Wiki] Update of "DocumentationPlan" by RobertBurrellDonkin
Date Sun, 30 Jul 2006 10:50:00 GMT
Dear Wiki user,

You have subscribed to a wiki page or wiki category on "Incubator Wiki" for change notification.

The following page has been changed by RobertBurrellDonkin:
http://wiki.apache.org/incubator/DocumentationPlan

The comment on the change is:
Document management - initial content

New page:
= Documentation Plan =

It takes time to produce adequate documentation. Often it's hard to merge changes so a little
organisation is a good idea. If you are working on substantial changes to a particular document
then sign up on here. Then people can either work on something else or post something to the
general list.

Not sure whether management via wiki will be better than via JIRA (create loads of tasks?)


== Page By Page ==

Feel free to update with new ideas etc

 * [http://incubator.apache.org/guides/proposal.html Guide For Proposals] is reasonably close.
there's editorial work needed proof-reading, adding links and add examples of good practice
from existing applications. there are a few difficult sections needing more content.

 * [http://incubator.apache.org/guides/participation.html Guide For Participation] is a new-ish
netiquette/getting involve guide. this needs more content and links into existing documentation
but is intended to be a short document.

 * [http://incubator.apache.org/guides/releasemanagement.html Release Management Guide] is
really just an outline. lot of work required. Project templates needed. 

 * http://incubator.apache.org/guides/projects.html is just a landing page. probably not a
good idea to take this one on ATM. Need a guide for mentors and projects which is what this
was probably intended to be. 

 * [http://incubator.apache.org/guides/entry.html Guide To Entry] is a landing page with basic
outline. lot of work required.

 * [http://incubator.apache.org/guides/lists.html Guide To Mailing Lists] needs tidying up.
the index page has a missing link to this page. the website content should be replaced with
a link to the website guide. more content on mailing list best practices would be good.

 * [http://incubator.apache.org/incubation/Process_Description.html Process Document] basically
sound but will need updating to link into the new content. References the Jakarta guide for
sub projects. This is not a good idea.  

 * [http://incubator.apache.org/incubation/Roles_and_Responsibilities.html Roles And Responsibilities]
too much duplication. Content needs to be consolidated and with more links added.

 * [http://incubator.apache.org/learn/ Learning Material] the rest of the material in here
needs to find new homes. rules for revoluntionaries is very badly formatted. the apache way
has some good points but reflects older thinking from the membership: moving away from talking
about the apache way and towards using open development as a term. perhaps history would be
a better place some of this content. need a new document somewhere in www.apache.org describing
open development.

* [http://incubator.apache.org/guides/ppmc.html PPMC Guide] Proof-read and decide upon a status
and abstract. Merge in material from the wiki. 

* [http://incubator.apache.org/guides/branding.html Branding Guide] Consensus about trademark
and naming need to be added. Once public relations have web presence, add links.

* [http://incubator.apache.org/guides/index.html Guide Index] fix broken links. Update list
so that drafts are included.

== Universal ==

* Add license headers - most of the documents are missing license headers. These need adding.

---------------------------------------------------------------------
To unsubscribe, e-mail: cvs-unsubscribe@incubator.apache.org
For additional commands, e-mail: cvs-help@incubator.apache.org


Mime
View raw message