Currently, the SiteMesh Plugin document contains much duplicated information regarding web.xml configuration. Some of the information, like the section entitled "Velocity," has errors in its example configuration (copy/paste errors that incorrectly reference FreeMarker).
- The "Full Integration" section references
WW-3296, but any relevant/useful information should be extracted from that ticket and used in the document directly.
Furthermore, the page neglects to give actual SiteMesh configuration examples. The 2.0.14 docs had a limited example, but this can be improved by adding a section on sitemesh.xml, a simple decorators.xml file (in the case when a ConfigDecoratorMapper is defined), a simple decorator, and a page to be decorated. These should be FreeMarker or Velocity examples to highlight the new functionality that Struts 2.2.1 affords.
In general the page could be more clear for newbies.