[
https://issues.apache.org/jira/browse/WW-5307?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=17723409#comment-17723409
]
nikos dimitrakas commented on WW-5307:
--------------------------------------
Funny that the page [https://struts.apache.org/tag-developers/ognl] does have
link to [http://commons.apache.org/proper/commons-ognl/] in the first paragraph
if that is not the correct version of ognl. For me, it does not matter if the
Struts documentation has its own page about ognl or if it links to another
place. The important thing is that the documentation is complete och correct.
An advantage of having an ognl page as part of the Struts documentation is that
the examples can be adapted to Struts. Otherwise, a link to the generic ognl
documentation should be fine. Struts specific ognl examples appear already in
the tag documentation.
The page at
[https://github.com/orphan-oss/ognl/blob/master/docs/LanguageGuide.md] is
basically a copy of
[https://commons.apache.org/proper/commons-ognl/language-guide.html]
> 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)
