forrest-svn mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From cross...@apache.org
Subject svn commit: r693362 - /forrest/trunk/site-author/content/xdocs/docs_0_90/upgrading_09.xml
Date Tue, 09 Sep 2008 04:53:56 GMT
Author: crossley
Date: Mon Sep  8 21:53:55 2008
New Revision: 693362

URL: http://svn.apache.org/viewvc?rev=693362&view=rev
Log:
Replace "placeholder" in Introduction section with that from past 0.8 notes. Copy other relevant
sections from 0.8 notes.

Modified:
    forrest/trunk/site-author/content/xdocs/docs_0_90/upgrading_09.xml

Modified: forrest/trunk/site-author/content/xdocs/docs_0_90/upgrading_09.xml
URL: http://svn.apache.org/viewvc/forrest/trunk/site-author/content/xdocs/docs_0_90/upgrading_09.xml?rev=693362&r1=693361&r2=693362&view=diff
==============================================================================
--- forrest/trunk/site-author/content/xdocs/docs_0_90/upgrading_09.xml (original)
+++ forrest/trunk/site-author/content/xdocs/docs_0_90/upgrading_09.xml Mon Sep  8 21:53:55
2008
@@ -30,8 +30,35 @@
         See the notes for obtaining and <a href="site:build">Building
         Forrest</a>.
       </note>
-      <p>This is a placeholder document for the new version.</p>
-<!-- FIXME: need to bring back some sections from the 0.8 version, temporarily removed
-->
+      <p>
+        This page describes some changes to Apache Forrest that affect people
+        who are upgrading to the 0.9 version. If you have other issues, then
+        please discuss on either the
+        <a href="site:mail-lists/forrest-dev">dev</a> or
+        <a href="site:mail-lists/forrest-user">user</a> mailing lists. As more
+        experience is gained, this document will be updated.
+      </p>
+      <p>
+        (If you are upgrading from a version prior to 0.8 then you will need to
+        see the notes for the previous upgrade.)
+      </p>
+    </section>
+    <section id="new">
+      <title>New Features</title>
+      <p>
+        The following list shows some of the key new features. For the full list
+        of changes, see the main <a href="site:changes">change log</a> and also
+        for each plugin.
+      </p>
+      <ul>
+        <li>[Placeholder]</li>
+      </ul>
+      <p>
+        Some new initial plugins are in the "whiteboard". See the entries in the
+        <a href="site:changes">change log</a> and see each plugin's
+        documentation and changes log. This includes the new Dispatcher. See
+        <a href="site:status-themes">Status of Themes: Skins and Dispatcher</a>.
+      </p>
     </section>
     <section id="missing-symbols">
       <title>Missing project symbols file in some projects</title>
@@ -57,5 +84,39 @@
         (added in v0.9 - <a href="site:faq/sitemap-entities">FAQ</a>).
       </p>
     </section>
+    <section id="tips">
+      <title>General upgrade tips</title>
+      <p>
+        Synchronise your project's skinconf.xml and forrest.properties files.
+      </p>
+      <p>
+        Take advantage of the separation of concerns. In a new workspace, create
+        a fresh '<code>forrest seed</code>' site, then tweak its
+        forrest.properties and skinconf.xml until it reflects your old site.
+        When it is ready, replace your project's skinconf.xml and
+        forrest.properties files. Any remaining issues would concern other
+        aspects of your configuration, such as site.xml and your actual content.
+      </p>
+    </section>
+    <section id="project-sitemap">
+      <title>Remove project sitemap if not necessary</title>
+      <p>
+        It has come to our attention that some people have a 
+        <a href="site:project-sitemap">project sitemap</a>
+        even though they are not using it. Such un-necessary sitemaps should be
+        removed to avoid maintenance issues.
+      </p>
+      <p>
+        If you do use a project sitemap, then pay attention to the 0.8 upgrade
+        instructions "<a href="site:upgrading_08">Forrest configuration simplification</a>".
+      </p>
+    </section>
+    <section>
+      <title>To be continued...</title>
+      <p>
+        ...as more issues are discovered/remembered :) Please send feedback to
+        the <a href="site:mail-lists/forrest-dev">mailing list</a>.
+      </p>
+    </section>
   </body>
 </document>



Mime
View raw message