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

nikos dimitrakas commented on WW-5307:
--------------------------------------

Yes. In that section near the end there is a "called projection" which referes 
to selection and no projection examples are shown. 

On the page 
[https://github.com/orphan-oss/ognl/blob/master/docs/LanguageGuide.md] there 
are examples for both projection and selection both in the sections "Projecting 
Across Collections" and "Selecting From Collections", and in the table with all 
the operators in the section "OGNL Language Reference".

How about your idea of linking to that page instead of maintaining the struts 
ognl page?

> 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