[jira] [Commented] (WW-3472) SiteMesh Plugin document improvements

["Lukasz Lenart (JIRA)" <ji...@apache.org>]

    [ https://issues.apache.org/jira/browse/WW-3472?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=14135056#comment-14135056 ] 

Lukasz Lenart commented on WW-3472:
-----------------------------------

[~rgm] maybe you could update that page? Looks like you have more wide knowledge than I in that area

> SiteMesh Plugin document improvements
> -------------------------------------
>
>                 Key: WW-3472
>                 URL: https://issues.apache.org/jira/browse/WW-3472
>             Project: Struts 2
>          Issue Type: Task
>          Components: Documentation
>    Affects Versions: 2.2.1
>            Reporter: Roland McIntosh
>            Priority: Minor
>             Fix For: 2.3.18
>
>
> 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.
> Current version:
> http://struts.apache.org/2.x/docs/sitemesh-plugin.html



--
This message was sent by Atlassian JIRA
(v6.3.4#6332)