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>
