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

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

The SiteMesh plugin was deprecated in 6.7.0 (WW-5471) and removed in 7.0.0 
(WW-5472), so rewriting its SiteMesh 2 examples is no longer worthwhile.

The plugin page now says it applies to versions before 7.0.0 only and points to 
the [sitemesh3 
example|https://github.com/apache/struts-examples/tree/main/sitemesh3], which 
integrates SiteMesh 3 directly with Struts 7. The plugins index marks it as 
"deprecated since 6.7.0, removed since 7.0.0" - see 
https://github.com/apache/struts-site/pull/350

Closing this ticket.

> 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: 7.5.0
>
>          Time Spent: 20m
>  Remaining Estimate: 0h
>
> 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
(v8.20.10#820010)

Reply via email to