[ 
https://issues.apache.org/jira/browse/WW-5307?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel
 ]

Lukasz Lenart updated WW-5307:
------------------------------
    Description: 
The documentation at [https://struts.apache.org/tag-developers/ognl] seems to 
confuse selection and projection. There is no example of projection and the 
examples of the three types of selection are called projection. 

The documentation at 
[https://commons.apache.org/proper/commons-ognl/language-guide.html] is correct 
and shows projection correctly in one section with the example 
listeners.\{delegate} and shows selection with examples in a separate section 
immediately after the projection section. Selection and projection are also 
separately explained in the table in the appendix at the bottom of the same 
page.

Perhaps the documentation of struts should have a link to the documentation of 
ognl instead of having its own examples. Or if there should be examples in the 
struts documentation, there should be examples for both projection and 
selection.

  was:
The documentation at [https://struts.apache.org/tag-developers/ognl] seems to 
confuse selection and projection. There is no example of projection and the 
examples of the three types of selection are called projection. 

The documentation at 
[https://commons.apache.org/proper/commons-ognl/language-guide.html] is correct 
and shows projection correctly in one section with the example 
listeners.{delegate} and shows selection with examples in a separate section 
immediately after the projection section. Selection and projection are also 
separately explained in the table in the appendix at the bottom of the same 
page.

Perhaps the documentation of struts should have a link to the documentation of 
ognl instead of having its own examples. Or if there should be examples in the 
struts documentation, there should be examples for both projection and 
selection.


> Confusing documentation about ognl
> ----------------------------------
>
>                 Key: WW-5307
>                 URL: https://issues.apache.org/jira/browse/WW-5307
>             Project: Struts 2
>          Issue Type: Bug
>          Components: Documentation
>            Reporter: nikos dimitrakas
>            Priority: Major
>             Fix For: 6.2.0
>
>
> The documentation at [https://struts.apache.org/tag-developers/ognl] seems to 
> confuse selection and projection. There is no example of projection and the 
> examples of the three types of selection are called projection. 
> The documentation at 
> [https://commons.apache.org/proper/commons-ognl/language-guide.html] is 
> correct and shows projection correctly in one section with the example 
> listeners.\{delegate} and shows selection with examples in a separate section 
> immediately after the projection section. Selection and projection are also 
> separately explained in the table in the appendix at the bottom of the same 
> page.
> Perhaps the documentation of struts should have a link to the documentation 
> of ognl instead of having its own examples. Or if there should be examples in 
> the struts documentation, there should be examples for both projection and 
> selection.



--
This message was sent by Atlassian Jira
(v8.20.10#820010)

Reply via email to