[jira] [Commented] (GEODE-7801) User Guide "Querying with OQL" page - sync with T of C

["Alberto Bustamante Reyes (Jira)" <ji...@apache.org>]

    [ 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)