[Geoserver-devel] [jira] Created: (GEOS-3194) CQL documentation

CQL documentation
-----------------

                 Key: GEOS-3194
                 URL: http://jira.codehaus.org/browse/GEOS-3194
             Project: GeoServer
          Issue Type: Improvement
          Components: Documentation
            Reporter: Jonathan
            Assignee: Andrea Aime

Hi,
The CQL documentation is very limited. On the old documentation there's an "unfinished" tutorial, the new docs have these pages:

http://docs.geoserver.org/1.7.x/user/tutorials/cql/cql_tutorial.html
and
http://docs.geoserver.org/1.7.x/user/services/wfs/vendor.html

but they're not much help. For the cql_tutorial one, would it be possible to actually show an example of a full url with CQL in it? That page only seems to have snippets of code which doesn't give much of a feel for how it works with the other parts of the URL.
Just a suggestion.

--
This message is automatically generated by JIRA.
-
If you think it was sent incorrectly contact one of the administrators: http://jira.codehaus.org/secure/Administrators.jspa
-
For more information on JIRA, see: http://www.atlassian.com/software/jira

aside, the documentation on <http://docs.geoserver.org/1.7.x/user/tutorials/cql/cql_tutorial.html&gt; states "CQL (Catalog Query Language)" when I'm pretty sure the acronym actually stands for "Common Query Language" and that's how it's documented on <http://geotools.codehaus.org/CQL+Parser+Design&gt;\.

Mike could you double check that and update the docs?

Cheers,
Gabriel

Jonathan (JIRA) wrote:

CQL documentation
-----------------

                 Key: GEOS-3194
                 URL: http://jira.codehaus.org/browse/GEOS-3194
             Project: GeoServer
          Issue Type: Improvement
          Components: Documentation
            Reporter: Jonathan
            Assignee: Andrea Aime

Hi,
The CQL documentation is very limited. On the old documentation there's an "unfinished" tutorial, the new docs have these pages:

http://docs.geoserver.org/1.7.x/user/tutorials/cql/cql_tutorial.html
and
http://docs.geoserver.org/1.7.x/user/services/wfs/vendor.html

but they're not much help. For the cql_tutorial one, would it be possible to actually show an example of a full url with CQL in it? That page only seems to have snippets of code which doesn't give much of a feel for how it works with the other parts of the URL.
Just a suggestion.

--
Gabriel Roldan
OpenGeo - http://opengeo.org
Expert service straight from the developers.

Gabriel Roldan ha scritto:

aside, the documentation on <http://docs.geoserver.org/1.7.x/user/tutorials/cql/cql_tutorial.html&gt; states "CQL (Catalog Query Language)" when I'm pretty sure the acronym actually stands for "Common Query Language" and that's how it's documented on <http://geotools.codehaus.org/CQL+Parser+Design&gt;\.

Mike could you double check that and update the docs?

Ah, that tutorial is my fault (first attempt at writing stuff in
rst). I'll fix it

Cheers
Andrea

--
Andrea Aime
OpenGeo - http://opengeo.org
Expert service straight from the developers.

Andrea Aime wrote:

Gabriel Roldan ha scritto:

aside, the documentation on <http://docs.geoserver.org/1.7.x/user/tutorials/cql/cql_tutorial.html&gt; states "CQL (Catalog Query Language)" when I'm pretty sure the acronym actually stands for "Common Query Language" and that's how it's documented on <http://geotools.codehaus.org/CQL+Parser+Design&gt;\.

Mike could you double check that and update the docs?

Ah, that tutorial is my fault (first attempt at writing stuff in
rst). I'll fix it

ah, cool then.
Cheers,
Gabriel

Cheers
Andrea

--
Gabriel Roldan
OpenGeo - http://opengeo.org
Expert service straight from the developers.