Page: http://wiki.cocoondev.org/Wiki.jsp?page=ForrestProposal , version: 46 on Sun Apr 6 10:20:20 2003 by DavidCrossley
- This is an evolving proposal to determine how to smoothly enable the Cocoon documentation to be built by [Apache Forrest|http://xml.apache.org/forrest/]. The outcome of this proposal will be a coherent Proposal email to the lists and subsequent Votes about certain apsects. + This is an evolving proposal to determine how to smoothly enable the Cocoon documentation to be built by [Apache Forrest|http://xml.apache.org/forrest/]. - We are experimenting with design-via-wiki and the [cocoon-docs|http://xml.apache.org/cocoon/mail-lists.html] mailing list. (If it does not work then we may try using CVS and mailing list instead.) - Let us start by determining the dot-points in the "Outline" section below, to express requirements and issues. Later we can refine those. ? --------------------------- + Let us start by determining the dot-points in the "Outline" section below, to express requirements and issues. - * Please keep the dot-point numbers, just add new ones at the bottom. In this way we can just refer to item numbers during email discussion. After a little while we can re-arrange the list items into a sensible order. ? ----------------------------------------------------------------------------- + * Please keep the dot-point numbers, just add new ones at the bottom. In this way we can just refer to item numbers during email discussion. - * If you want to make major changes then please be sure to discuss that on cocoon-docs. + * If you want to make major changes then please be sure to discuss that on [cocoon-docs|http://xml.apache.org/cocoon/mail-lists.html]. ? + +++++++++++ +++++++++++++++++++++++++++++++++++ + + #Lots of discussion on cocoon-docs in late-March 2003 - PROPOSAL + DECISION - * Update CVS during the transition period. + * One person needs to update CVS when they are happy with the transition, then others can help to refine it. - !7. Expect a team of people to help, especially during the transition of xdocs. ? ^ ^^^^^ + !7. Expect a few people to help, especially during the transition of xdocs. ? ^ ^ - * Define an actual week when people will be available. The vote on this proposal will draw some more people to help. + * At some stage we are going to need to just break the docs/webapp-docs parts of cocoon-2.1 and this disruption will take a few people to put it back together. - PROPOSAL + DECISION - !9. Use a consistent version of Forrest by all team members during the transition phase. ? -------------------- + !9. Use a consistent version of Forrest during the transition phase. - PROPOSAL - * Use the stable HEAD at the time and continue with this until the job is done. + DECISION + * Forrest cvs head now has a cvs tag called "stable". - PROPOSAL - * Use the tabs that are suggested below. + DECISION + * Use the tabs that are suggested below. These are easy to re-arrange. - PROPOSAL + DECISION - !15. Do the old DTDs and OASIS Catalog entries need to remain in Cocoon CVS? Other people may be still using them for their own projects. + !15. Do the old documnet-v10 DTDs and OASIS Catalog entries need to remain in Cocoon CVS? Other people may be still using them for their own projects. ? +++++++++++++ - * Leave this issue until after transition is finished. + * Leave this issue until after transition is finished. Forrestbot already addresses part of this need. + PROPOSAL + * Open + * 2003-04-06 Noted some decisions and fine-tuned the text. - * 2002-11-12 Added comments - * 2002-11-14 Sent a call to cocoon-dev, cocoon-users, and forrest-dev to ask more people to come to cocoon-docs to discuss this proposal. - * 2002-11-15 Added comments from recent email. - - * 2002-11-21 Added some items from the recent conversion trial and added new wiki page [HowToForrestTransition] - * 2002-11-26 Reformatted to make discussion easier and added some items - * 2002-12-28 Fine-tuned the whole proposal - * 2002-12-31 Added item 19.
