crossley 02/05/07 01:16:37
Modified: src/documentation/xdocs book.xml
src/documentation/xdocs/plan book.xml catalog.xml doc.xml
index.xml release.xml
Log:
Reviewed some of the planning documents to remove old stuff.
Tidy up in readiness for the Documentation Deluge.
Link in the new Documentation ToDo.
Revision Changes Path
1.10 +1 -0 xml-cocoon2/src/documentation/xdocs/book.xml
Index: book.xml
===================================================================
RCS file: /home/cvs/xml-cocoon2/src/documentation/xdocs/book.xml,v
retrieving revision 1.9
retrieving revision 1.10
diff -u -r1.9 -r1.10
--- book.xml 18 Apr 2002 16:15:29 -0000 1.9
+++ book.xml 7 May 2002 08:16:36 -0000 1.10
@@ -26,6 +26,7 @@
<menu label="Status">
<menu-item label="Changes" href="changes.html"/>
<menu-item label="Todo" href="todo.html"/>
+ <menu-item label="Planning notes" href="plan/index.html"/>
<external label="Patch queue"
href="http://nagoya.apache.org/bugzilla/buglist.cgi?bug_status=NEW&bug_status=ASSIGNED&bug_status=REOPENED&email1=&emailtype1=substring&emailassigned_to1=1&email2=&emailtype2=substring&emailreporter2=1&bugidtype=include&bug_id=&changedin=&votes=&chfieldfrom=&chfieldto=Now&chfieldvalue=&product=Cocoon+2&short_desc=%5BPATCH%5D&short_desc_type=allwordssubstr&long_desc=&long_desc_type=allwordssubstr&bug_file_loc=&bug_file_loc_type=allwordssubstr&keywords=&keywords_type=anywords&field0-0-0=noop&type0-0-0=noop&value0-0-0=&namedcmd=Cocoon+all&newqueryname=cocoon+patch+queue&tofooter=1&order=Reuse+same+sort+as+last+time"/>
</menu>
1.2 +3 -2 xml-cocoon2/src/documentation/xdocs/plan/book.xml
Index: book.xml
===================================================================
RCS file: /home/cvs/xml-cocoon2/src/documentation/xdocs/plan/book.xml,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -r1.1 -r1.2
--- book.xml 3 Jan 2002 12:31:03 -0000 1.1
+++ book.xml 7 May 2002 08:16:37 -0000 1.2
@@ -9,10 +9,11 @@
<menu-item label="Main" href="../index.html"/>
</menu>
- <menu label="Planning Documents">
+ <menu label="Planning notes">
<menu-item label="Release Plan" href="release.html"/>
- <menu-item label="To Avalon" href="to-avalon.html"/>
<menu-item label="Documentation" href="doc.html"/>
+ <menu-item label="Doc ToDo" href="todo-doc.html"/>
+ <menu-item label="To Avalon" href="to-avalon.html"/>
<menu-item label="Entity Catalogs" href="catalog.html"/>
</menu>
</book>
1.2 +13 -0 xml-cocoon2/src/documentation/xdocs/plan/catalog.xml
Index: catalog.xml
===================================================================
RCS file: /home/cvs/xml-cocoon2/src/documentation/xdocs/plan/catalog.xml,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -r1.1 -r1.2
--- catalog.xml 3 Jan 2002 12:31:03 -0000 1.1
+++ catalog.xml 7 May 2002 08:16:37 -0000 1.2
@@ -89,6 +89,12 @@
<note>TODO: describe overview of issues.</note>
+ <p>
+ Evidently this has
+ <link href="to-avalon.html">already happened</link>.
+ We will need to investigate and see what changes need to be made to the
+ relevant Cocoon docs.
+ </p>
</s1>
<s1 title="Other Notes">
@@ -114,6 +120,13 @@
<ul>
<li>Cocoon distribution + Resolver Resolution ? (avalon-dev 2001-11-12)
discusses licencing issues and moving to Avalon</li>
+ <li><link
href="http://marc.theaimsgroup.com/?l=xml-apache-general&m=100703897109799&w=2";>[vote]
Accepting Entity Resolver Donation</link>
+ (apache-general 2001-11-29)</li>
+ <li>[excalibur] Catalog code
+ (avalon-dev, cocoon-dev 2001-09-23)</li>
+ <li>
+ <link
href="http://marc.theaimsgroup.com/?l=xml-cocoon-dev&m=100303902726035&w=2";>cvs
commit: xml-cocoon2 LISCENSE.resolver</link>
+ (cocoon-dev 2001-10-14)</li>
</ul>
</s1>
1.2 +28 -42 xml-cocoon2/src/documentation/xdocs/plan/doc.xml
Index: doc.xml
===================================================================
RCS file: /home/cvs/xml-cocoon2/src/documentation/xdocs/plan/doc.xml,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -r1.1 -r1.2
--- doc.xml 3 Jan 2002 12:31:03 -0000 1.1
+++ doc.xml 7 May 2002 08:16:37 -0000 1.2
@@ -22,38 +22,42 @@
required additional documents. At the bottom is a list of general issues.
</p>
+ <p>Please also see the <link href="todo-doc.html">Documentation ToDo
+ List</link>
+ </p>
</s1>
<s1 title="Revisions required">
- <ul>
- <li>Announcement (announcement.xml)
- <ul>
- <li>Needs to be more positive</li>
- <li>Needs a concise overview of Cocoon (which can be re-used on the home
page)</li>
- </ul>
- </li>
-
- <li>The home page (index.xml)
- <ul>
- <li>needs to be more positive</li>
- <li>Can now stop apologising for Cocoon 1</li>
- <li>Needs concise overiew at top - "What is It"</li>
- </ul>
- </li>
-
- <li>Frequently Asked Questions
- <ul>
- <li>Needs re-structure or we will have the same un-wieldy monster FAQ as
+ <s2 title="Announcement (announcement.xml)">
+ <ul>
+<!-- this may be out-of-date, it was enhanced recently -->
+ <li>Needs to be more positive</li>
+ <li>Needs a concise overview of Cocoon (which can be re-used on the
+ home page)</li>
+ </ul>
+ </s2>
+
+ <s2 title="The home page (index.xml)">
+ <ul>
+<!-- this may be out-of-date, it was enhanced recently -->
+ <li>needs to be more positive</li>
+ <li>Can now stop apologising for Cocoon 1</li>
+ <li>Needs concise overiew at top - "What is It"</li>
+ </ul>
+ </s2>
+
+ <s2 title="Frequently Asked Questions">
+ <ul>
+ <li>Needs re-structure or we will have the same un-wieldy monster FAQ as
for Cocoon 1.
- </li>
- </ul>
- </li>
+ </li>
+ </ul>
+ </s2>
- </ul>
</s1>
- <s1 title="Fix the placeholder documents">
+ <s1 title="Fix any placeholder documents">
<p>
These pages have a shell, but no content yet. They currently have the
@@ -63,15 +67,6 @@
<ul>
<li>Index pages for "Developing" and "Userdocs"</li>
<li>userdocs/actions/actions.xml</li>
-<!--
- <li>
- <ul>
- <li>
- </li>
- </ul>
- </li>
--->
-
</ul>
</s1>
@@ -79,15 +74,6 @@
<ul>
<li></li>
-<!--
- <li>
- <ul>
- <li>
- </li>
- </ul>
- </li>
--->
-
</ul>
</s1>
1.2 +4 -3 xml-cocoon2/src/documentation/xdocs/plan/index.xml
Index: index.xml
===================================================================
RCS file: /home/cvs/xml-cocoon2/src/documentation/xdocs/plan/index.xml,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -r1.1 -r1.2
--- index.xml 3 Jan 2002 12:31:03 -0000 1.1
+++ index.xml 7 May 2002 08:16:37 -0000 1.2
@@ -17,7 +17,7 @@
development.
</p>
- <p>There is much discussion of issues and research topics (RT) threads on
+ <p>There is much discussion of issues and Random Thought (RT) threads on
the <code>cocoon-dev</code> mailing list (and elsewhere). However, details
get lost in the sheer volume. This is the place to document the summary of
discussions on some key topics. Some new and complex capabilities will take
@@ -45,10 +45,11 @@
<ul>
<li><link href="release.html">Release Plan</link>
- - major things to do before the 2.0 release</li>
- <li><link href="to-avalon.html">Moving some Components to Avalon</link></li>
+ - major things to do before the next release</li>
<li><link href="doc.html">Documentation</link>
- revisions and additions are required</li>
+ <li><link href="todo-doc.html">Documentation ToDo List</link></li>
+ <li><link href="to-avalon.html">Moving some Components to Avalon</link></li>
<li><link href="catalog.html">Entity Catalogs</link>
- the entity resolver</li>
<li>See the general <link href="../todo.html">To Do</link> list
1.2 +2 -5 xml-cocoon2/src/documentation/xdocs/plan/release.xml
Index: release.xml
===================================================================
RCS file: /home/cvs/xml-cocoon2/src/documentation/xdocs/plan/release.xml,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -r1.1 -r1.2
--- release.xml 3 Jan 2002 12:31:03 -0000 1.1
+++ release.xml 7 May 2002 08:16:37 -0000 1.2
@@ -3,7 +3,7 @@
<document>
<header>
- <title>Release Plan 2.0</title>
+ <title>Release Plan</title>
<subtitle>Planning Documentation</subtitle>
<authors>
<person name="David Crossley" email="[EMAIL PROTECTED]"/>
@@ -11,10 +11,7 @@
</header>
<body>
- <s1 title="Preparation for release of Apache Cocoon 2.0">
-
- <p>The 2.0 final release is scheduled for the end of November 2001.
- </p>
+ <s1 title="Preparation for the next release of Apache Cocoon">
<p>
The following is extracted from the thread
----------------------------------------------------------------------
In case of troubles, e-mail: [EMAIL PROTECTED]
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]
