[
https://issues.apache.org/jira/browse/GEODE-7801?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=17120931#comment-17120931
]
Alberto Bustamante Reyes commented on GEODE-7801:
-------------------------------------------------
[~dbarnes] would you agree with these points?
* Move the content of "Advantages of OQL" into "Querying with OQL"
* Promote "Writing and Executing a Query in Geode" to the same level as
"Querying with OQL
* Move the subsections of "Querying with OQL" that are after "Writing and
Executing a Query in Geode" to be subsections of the promoted "Writing and
Executing a Query in Geode" (I think with this change the current order of the
chapter will be kept)
So the left menu will look as this:
* Querying
** Geode Querying FAQ and Examples
** Querying wth OQL
** Writing and Executing a Query in Geode
*** Building a Query String (and its subsections )
*** OQL Syntax and Semantics (and its subsections )
*** Query Language Restrictions and Unsupported Features
> User Guide "Querying with OQL" page - sync with T of C
> ------------------------------------------------------
>
> Key: GEODE-7801
> URL: https://issues.apache.org/jira/browse/GEODE-7801
> Project: Geode
> Issue Type: Improvement
> Components: docs
> Reporter: Dave Barnes
> Assignee: Alberto Bustamante Reyes
> Priority: Minor
>
> The "Querying with OQL" page
> ([https://geode.apache.org/docs/guide/111/developing/querying_basics/query_basics.html])
> has two subsidiary pages listed in the left-hand navigation pane, but
> they're not referenced in the page text itself.
> Given that the LH-nav is collapsed by default, it's (too) easy for the reader
> to overlook the subtopics (Advantages of OQL and Writing and Executing a
> Query in Geode).
> One solution would be to place links in the Querying with OQL page. Another
> would be to pull the subtopics into the Querying with OQL page and
> eliminating the extra level in the nav.
> A third possibility (perhaps the best) would be to elevate the Writing and
> Executing subtopic to a more prominent spot in the hierarchy - it seems kinda
> buried in its current position.
--
This message was sent by Atlassian Jira
(v8.3.4#803005)
