diff --git a/spring-webflow-reference/src/spring-faces.xml b/spring-webflow-reference/src/spring-faces.xml
index 5e53fbb5..f033f855 100644
--- a/spring-webflow-reference/src/spring-faces.xml
+++ b/spring-webflow-reference/src/spring-faces.xml
@@ -127,6 +127,51 @@
.xhtml
]]>
+
+ For optimal page-loading performance, the Spring Faces component library includes a few special components:
+ includeStyles and includeScripts. These components will eagerly load the neccessary
+ CSS stylesheets and JavaScript files at the position they are placed in your JSF view template. In accordance
+ with the recommendations of the Yahoo Performance Guildlines, these two tags should be placed in the head
+ section of any page that uses the Spring Faces components. For example:
+
+
+
+
+
+
+ Spring Faces: Hotel Booking Sample Application
+
+
+
+
+
+
+...
+
+]]>
+
+
+ This shows the opening of a typical Facelets XHTML layout template that uses these components to force the loading of
+ the needed CSS and JavaScript resources at the ideal position.
+
+
+ The includeStyles component includes the necessary resources for the Dojo widget theme. By default, it includes
+ the resources for the "tundra" theme. An alternate theme may be selected by setting the optional "theme" and "themePath" attributes
+ on the includeStyles component. For example:
+
+
+]]>
+
+
+ will try to load a CSS stylesheet at "/styles/foobar/foobar.css" using the Spring JavaScript ResourceServlet.
+
Configuring Web Flow to render JSF views
@@ -566,7 +611,7 @@
Enhancing The User Experience With Rich Web Forms
- JSF and Web Flow combine to provide and extensive server-side validation model for your web application, but
+ JSF and Web Flow combine to provide an extensive server-side validation model for your web application, but
excessive roundtrips to the server to execute this validation and return error messages can be a tedious
experience for your users. Spring Faces provides a number of client-side rich validation controls that can
enhance the user experience by applying simple validations that give immediate feedback. Some simple