[Geoserver-devel] Proposal for reorganizing Working With Data section in the User Guide

GeoServer GeoServer Developer
, ,
1

The Working with Data section in the User Guide seems to be getting a bit unwieldy. It might be nice to split it up in a way that highlights the different kinds of data: Vector, Raster, Database, and External Services.

Here’s a proposal for a new structure, which replaces the current section with 4 new ones:

Working with Vector Data

Shapefile
Directory of spatial files
GML
VPF
Java Properties
Pregeneralized Features

Working with Raster Data

ArcGrid
GeoTIFF
GTOPO30
ImageMosaic
WorldImage

GDAL Image Formats
ImagePyramid
Image Mosaic JDBC
Oracle Georaster
Custom JDBC Access for image data

Working with Databases

PostGIS
Oracle
Microsoft SQL Server and SQL Azure

DB2
H2
MySQL

Teradata
ArcSDE
Database Connection Pooling
SQL Views
Controlling feature ID generation in spatial databases
Custom SQL session start/stop scripts
Using SQL session scripts to control authorizations at the database level
Application Schema Support
JNDI

Working with External Data

External Web Feature Server
External Web Map Server

The only new content would be the index page for each new section. This will be a convenient place to put any general advice about working with the different kinds of formats (eg. links to the Styling pages for each type)

Alternatively, these could be 4 subsections under the main Working With Data section, although this would require more levels on the main TOC.

It might make sense for the source directory structure to mirror this organization, but this is not essential if there are issues with doing that (e.g existing URL references)

Thoughts or issues with doing this?

–

Martin Davis
OpenGeo - http://opengeo.org
Expert service straight from the developers.

2

Hey Martin,

Definitely +1 on some reorganization. Perhaps the last section might be better named “Working with Cascaded Services” since “external data” could mean a lot fo things… like an external database, etc… no strong opinion there though. I am happy with whatever you come up with.

-Justin

On Mon, Apr 30, 2012 at 10:30 PM, Martin Davis <mdavis@anonymised.com> wrote:

The Working with Data section in the User Guide seems to be getting a bit unwieldy. It might be nice to split it up in a way that highlights the different kinds of data: Vector, Raster, Database, and External Services.

Here’s a proposal for a new structure, which replaces the current section with 4 new ones:

Working with Vector Data

Shapefile
Directory of spatial files
GML
VPF
Java Properties
Pregeneralized Features

Working with Raster Data

ArcGrid
GeoTIFF
GTOPO30
ImageMosaic
WorldImage

GDAL Image Formats
ImagePyramid
Image Mosaic JDBC
Oracle Georaster
Custom JDBC Access for image data

Working with Databases

PostGIS
Oracle
Microsoft SQL Server and SQL Azure

DB2
H2
MySQL

Teradata
ArcSDE
Database Connection Pooling
SQL Views
Controlling feature ID generation in spatial databases
Custom SQL session start/stop scripts
Using SQL session scripts to control authorizations at the database level
Application Schema Support
JNDI

Working with External Data

External Web Feature Server
External Web Map Server

The only new content would be the index page for each new section. This will be a convenient place to put any general advice about working with the different kinds of formats (eg. links to the Styling pages for each type)

Alternatively, these could be 4 subsections under the main Working With Data section, although this would require more levels on the main TOC.

It might make sense for the source directory structure to mirror this organization, but this is not essential if there are issues with doing that (e.g existing URL references)

Thoughts or issues with doing this?

–

Martin Davis
OpenGeo - http://opengeo.org
Expert service straight from the developers.

Live Security Virtual Conference
Exclusive live event will cover all the ways today’s security and
threat landscape has changed and how IT managers can respond. Discussions
will include endpoint security, mobile security and the latest in malware
threats. http://www.accelacomm.com/jaw/sfrnl04242012/114/50122263/

Geoserver-devel mailing list
Geoserver-devel@anonymised.comsts.sourceforge.net
https://lists.sourceforge.net/lists/listinfo/geoserver-devel

–
Justin Deoliveira
OpenGeo - http://opengeo.org
Enterprise support for open source geospatial.

3

Yes, agreed. I find “External Data” to be pretty inexact as well. I was thinking that this could be called “Working with Remote Services”, but “Cascaded Services” is even more descriptive.

On Mon, Apr 30, 2012 at 4:30 PM, Justin Deoliveira <jdeolive@anonymised.com> wrote:

Hey Martin,

Definitely +1 on some reorganization. Perhaps the last section might be better named “Working with Cascaded Services” since “external data” could mean a lot fo things… like an external database, etc… no strong opinion there though. I am happy with whatever you come up with.

-Justin

On Mon, Apr 30, 2012 at 10:30 PM, Martin Davis <mdavis@anonymised.com.> wrote:

The Working with Data section in the User Guide seems to be getting a bit unwieldy. It might be nice to split it up in a way that highlights the different kinds of data: Vector, Raster, Database, and External Services.

Here’s a proposal for a new structure, which replaces the current section with 4 new ones:

Working with Vector Data

Shapefile
Directory of spatial files
GML
VPF
Java Properties
Pregeneralized Features

Working with Raster Data

ArcGrid
GeoTIFF
GTOPO30
ImageMosaic
WorldImage

GDAL Image Formats
ImagePyramid
Image Mosaic JDBC
Oracle Georaster
Custom JDBC Access for image data

Working with Databases

PostGIS
Oracle
Microsoft SQL Server and SQL Azure

DB2
H2
MySQL

Teradata
ArcSDE
Database Connection Pooling
SQL Views
Controlling feature ID generation in spatial databases
Custom SQL session start/stop scripts
Using SQL session scripts to control authorizations at the database level
Application Schema Support
JNDI

Working with External Data

External Web Feature Server
External Web Map Server

The only new content would be the index page for each new section. This will be a convenient place to put any general advice about working with the different kinds of formats (eg. links to the Styling pages for each type)

Alternatively, these could be 4 subsections under the main Working With Data section, although this would require more levels on the main TOC.

It might make sense for the source directory structure to mirror this organization, but this is not essential if there are issues with doing that (e.g existing URL references)

Thoughts or issues with doing this?

–

Martin Davis
OpenGeo - http://opengeo.org
Expert service straight from the developers.

Live Security Virtual Conference
Exclusive live event will cover all the ways today’s security and
threat landscape has changed and how IT managers can respond. Discussions
will include endpoint security, mobile security and the latest in malware
threats. http://www.accelacomm.com/jaw/sfrnl04242012/114/50122263/

Geoserver-devel mailing list
Geoserver-devel@lists.sourceforge.net
https://lists.sourceforge.net/lists/listinfo/geoserver-devel

–
Justin Deoliveira
OpenGeo - http://opengeo.org
Enterprise support for open source geospatial.

–

Martin Davis
OpenGeo - http://opengeo.org
Expert service straight from the developers.

4

+1 on the reorg in general, and on cascaded services.

On Tue, May 1, 2012 at 4:54 AM, Martin Davis <mdavis@anonymised.com> wrote:

Yes, agreed. I find "External Data" to be pretty inexact as well. I was
thinking that this could be called "Working with Remote Services", but
"Cascaded Services" is even more descriptive.

On Mon, Apr 30, 2012 at 4:30 PM, Justin Deoliveira <jdeolive@anonymised.com>
wrote:

Hey Martin,

Definitely +1 on some reorganization. Perhaps the last section might be
better named "Working with Cascaded Services" since "external data" could
mean a lot fo things... like an external database, etc... no strong opinion
there though. I am happy with whatever you come up with.

-Justin

On Mon, Apr 30, 2012 at 10:30 PM, Martin Davis <mdavis@anonymised.com> wrote:

The Working with Data section in the User Guide seems to be getting a bit
unwieldy. It might be nice to split it up in a way that highlights the
different kinds of data: Vector, Raster, Database, and External Services.

Here's a proposal for a new structure, which replaces the current section
with 4 new ones:

Working with Vector Data

Shapefile
Directory of spatial files
GML
VPF
Java Properties
Pregeneralized Features

Working with Raster Data

ArcGrid
GeoTIFF
GTOPO30
ImageMosaic
WorldImage
GDAL Image Formats
ImagePyramid
Image Mosaic JDBC
Oracle Georaster
Custom JDBC Access for image data

Working with Databases

PostGIS
Oracle
Microsoft SQL Server and SQL Azure
DB2
H2
MySQL
Teradata
ArcSDE
Database Connection Pooling
SQL Views
Controlling feature ID generation in spatial databases
Custom SQL session start/stop scripts
Using SQL session scripts to control authorizations at the database level
Application Schema Support
JNDI

Working with External Data

External Web Feature Server
External Web Map Server

The only new content would be the index page for each new section. This
will be a convenient place to put any general advice about working with the
different kinds of formats (eg. links to the Styling pages for each type)

Alternatively, these could be 4 subsections under the main Working With
Data section, although this would require more levels on the main TOC.

It might make sense for the source directory structure to mirror this
organization, but this is not essential if there are issues with doing that
(e.g existing URL references)

Thoughts or issues with doing this?

--
Martin Davis
OpenGeo - http://opengeo.org
Expert service straight from the developers.

------------------------------------------------------------------------------
Live Security Virtual Conference
Exclusive live event will cover all the ways today's security and
threat landscape has changed and how IT managers can respond. Discussions
will include endpoint security, mobile security and the latest in malware
threats. http://www.accelacomm.com/jaw/sfrnl04242012/114/50122263/
_______________________________________________
Geoserver-devel mailing list
Geoserver-devel@lists.sourceforge.net
https://lists.sourceforge.net/lists/listinfo/geoserver-devel

--
Justin Deoliveira
OpenGeo - http://opengeo.org
Enterprise support for open source geospatial.

--
Martin Davis
OpenGeo - http://opengeo.org
Expert service straight from the developers.

------------------------------------------------------------------------------
Live Security Virtual Conference
Exclusive live event will cover all the ways today's security and
threat landscape has changed and how IT managers can respond. Discussions
will include endpoint security, mobile security and the latest in malware
threats. http://www.accelacomm.com/jaw/sfrnl04242012/114/50122263/
_______________________________________________
Geoserver-devel mailing list
Geoserver-devel@lists.sourceforge.net
https://lists.sourceforge.net/lists/listinfo/geoserver-devel

5

On Tue, May 1, 2012 at 8:44 AM, Chris Holmes <cholmes@anonymised.com> wrote:

+1 on the reorg in general, and on cascaded services.

+1 here too

Cheers
Andrea

–

Ing. Andrea Aime
GeoSolutions S.A.S.
Tech lead

Via Poggio alle Viti 1187
55054 Massarosa (LU)
Italy

phone: +39 0584 962313
fax: +39 0584 962313
mob: +39 339 8844549

http://www.geo-solutions.it
http://geo-solutions.blogspot.com/
http://www.youtube.com/user/GeoSolutionsIT
http://www.linkedin.com/in/andreaaime
http://twitter.com/geowolf

6

Ok, great. I’ll work on this as I have time.

On Tue, May 1, 2012 at 5:35 AM, Andrea Aime <andrea.aime@anonymised.com…1268…> wrote:

On Tue, May 1, 2012 at 8:44 AM, Chris Holmes <cholmes@anonymised.com> wrote:

+1 on the reorg in general, and on cascaded services.

+1 here too

–

Martin Davis
OpenGeo - http://opengeo.org
Expert service straight from the developers.

7

Further to this task, I’ve prototyped the new directory structure and TOC of the User Guide, with the new Data sections. The HTML of the TOC is attached for review of the structure and URL naming.

This is a fairly major reorganization, and I’ve tried to strike a balance between creating a structure that reflects the actual content organization, and minimizing the impact on the directory structure. In particular,

  • the app-schema content tree is not changed
  • this seem to required continuing to have a Working With Data section. This isn’t a bad thing - it is a good location to put general content on data
  • otherwise, content pages are now moved to new directories under the data directory. Each has its own index.rst file. This is also a good thing, since the index pages can now be tailored more appropriately to the type of content.

If this looks good, I will start implementing the structure in SVN. Since it will take some time, I’m planning to stage it over multiple commits.

On Wed, May 2, 2012 at 9:33 AM, Martin Davis <mdavis@anonymised.com> wrote:

Ok, great. I’ll work on this as I have time.

On Tue, May 1, 2012 at 5:35 AM, Andrea Aime <andrea.aime@anonymised.com> wrote:

On Tue, May 1, 2012 at 8:44 AM, Chris Holmes <cholmes@anonymised.com> wrote:

+1 on the reorg in general, and on cascaded services.

+1 here too

–

Martin Davis
OpenGeo - http://opengeo.org
Expert service straight from the developers.

–

Martin Davis
OpenGeo - http://opengeo.org
Expert service straight from the developers.

(attachments)

index.html (22.2 KB)

8

The doc structure looks nice, much more clear. Thanks.

Regards,
Alessio.

Ing. Alessio Fabiani
Founder / CTO GeoSolutions S.A.S.

GeoSolutions S.A.S.
Via Poggio alle Viti 1187
55054 Massarosa (LU)
Italy

phone: (+39) 0584 96.23.13
fax: (+39) 0584 96.23.13
mobile:(+39) 331 62.33.686

http://www.geo-solutions.it
http://geo-solutions.blogspot.com
http://www.linkedin.com/in/alessiofabiani
https://twitter.com/alfa7961
http://twitter.com/geosolutions_it

On Tue, May 15, 2012 at 2:24 AM, Martin Davis <mdavis@anonymised.com> wrote:

Further to this task, I’ve prototyped the new directory structure and TOC of the User Guide, with the new Data sections. The HTML of the TOC is attached for review of the structure and URL naming.

This is a fairly major reorganization, and I’ve tried to strike a balance between creating a structure that reflects the actual content organization, and minimizing the impact on the directory structure. In particular,

  • the app-schema content tree is not changed
  • this seem to required continuing to have a Working With Data section. This isn’t a bad thing - it is a good location to put general content on data
  • otherwise, content pages are now moved to new directories under the data directory. Each has its own index.rst file. This is also a good thing, since the index pages can now be tailored more appropriately to the type of content.

If this looks good, I will start implementing the structure in SVN. Since it will take some time, I’m planning to stage it over multiple commits.

On Wed, May 2, 2012 at 9:33 AM, Martin Davis <mdavis@anonymised.com> wrote:

Ok, great. I’ll work on this as I have time.

On Tue, May 1, 2012 at 5:35 AM, Andrea Aime <andrea.aime@anonymised.com> wrote:

On Tue, May 1, 2012 at 8:44 AM, Chris Holmes <cholmes@anonymised.com> wrote:

+1 on the reorg in general, and on cascaded services.

+1 here too

–

Martin Davis
OpenGeo - http://opengeo.org
Expert service straight from the developers.

–

Martin Davis
OpenGeo - http://opengeo.org
Expert service straight from the developers.

Live Security Virtual Conference
Exclusive live event will cover all the ways today’s security and
threat landscape has changed and how IT managers can respond. Discussions
will include endpoint security, mobile security and the latest in malware
threats. http://www.accelacomm.com/jaw/sfrnl04242012/114/50122263/

Geoserver-devel mailing list
Geoserver-devel@anonymised.comsts.sourceforge.net
https://lists.sourceforge.net/lists/listinfo/geoserver-devel

9

This reorganization is now committed. Review and comments are welcome.

http://docs.geoserver.org/latest/en/user/data/vector/index.html
http://docs.geoserver.org/latest/en/user/data/raster/index.html
http://docs.geoserver.org/latest/en/user/data/database/index.html
http://docs.geoserver.org/latest/en/user/data/cascaded/index.html

The one remaining issue is what to do with the Application Schema section. It now languishes all alone under the Working With Data
heading. One idea might be to promote it to its own primary section?

http://docs.geoserver.org/latest/en/user/data/index.html

On Mon, Apr 30, 2012 at 3:30 PM, Martin Davis <mdavis@…1501…> wrote:

The Working with Data section in the User Guide seems to be getting a bit unwieldy. It might be nice to split it up in a way that highlights the different kinds of data: Vector, Raster, Database, and External Services.

Here’s a proposal for a new structure, which replaces the current section with 4 new ones:

Working with Vector Data

Shapefile
Directory of spatial files
GML
VPF
Java Properties
Pregeneralized Features

Working with Raster Data

ArcGrid
GeoTIFF
GTOPO30
ImageMosaic
WorldImage

GDAL Image Formats
ImagePyramid
Image Mosaic JDBC
Oracle Georaster
Custom JDBC Access for image data

Working with Databases

PostGIS
Oracle
Microsoft SQL Server and SQL Azure

DB2
H2
MySQL

Teradata
ArcSDE
Database Connection Pooling
SQL Views
Controlling feature ID generation in spatial databases
Custom SQL session start/stop scripts
Using SQL session scripts to control authorizations at the database level
Application Schema Support
JNDI

Working with External Data

External Web Feature Server
External Web Map Server

The only new content would be the index page for each new section. This will be a convenient place to put any general advice about working with the different kinds of formats (eg. links to the Styling pages for each type)

Alternatively, these could be 4 subsections under the main Working With Data section, although this would require more levels on the main TOC.

It might make sense for the source directory structure to mirror this organization, but this is not essential if there are issues with doing that (e.g existing URL references)

Thoughts or issues with doing this?

–

Martin Davis
OpenGeo - http://opengeo.org
Expert service straight from the developers.

–

Martin Davis
OpenGeo - http://opengeo.org
Expert service straight from the developers.

10

Yeah, I think it deserves its own section, there is certainly no shortage of content there! I would maybe put it at the top level under “Working with Application Schemas”.

On Sun, Jun 3, 2012 at 11:49 PM, Martin Davis <mdavis@anonymised.com> wrote:

This reorganization is now committed. Review and comments are welcome.

http://docs.geoserver.org/latest/en/user/data/vector/index.html
http://docs.geoserver.org/latest/en/user/data/raster/index.html
http://docs.geoserver.org/latest/en/user/data/database/index.html
http://docs.geoserver.org/latest/en/user/data/cascaded/index.html

The one remaining issue is what to do with the Application Schema section. It now languishes all alone under the Working With Data
heading. One idea might be to promote it to its own primary section?

http://docs.geoserver.org/latest/en/user/data/index.html

On Mon, Apr 30, 2012 at 3:30 PM, Martin Davis <mdavis@anonymised.com> wrote:

The Working with Data section in the User Guide seems to be getting a bit unwieldy. It might be nice to split it up in a way that highlights the different kinds of data: Vector, Raster, Database, and External Services.

Here’s a proposal for a new structure, which replaces the current section with 4 new ones:

Working with Vector Data

Shapefile
Directory of spatial files
GML
VPF
Java Properties
Pregeneralized Features

Working with Raster Data

ArcGrid
GeoTIFF
GTOPO30
ImageMosaic
WorldImage

GDAL Image Formats
ImagePyramid
Image Mosaic JDBC
Oracle Georaster
Custom JDBC Access for image data

Working with Databases

PostGIS
Oracle
Microsoft SQL Server and SQL Azure

DB2
H2
MySQL

Teradata
ArcSDE
Database Connection Pooling
SQL Views
Controlling feature ID generation in spatial databases
Custom SQL session start/stop scripts
Using SQL session scripts to control authorizations at the database level
Application Schema Support
JNDI

Working with External Data

External Web Feature Server
External Web Map Server

The only new content would be the index page for each new section. This will be a convenient place to put any general advice about working with the different kinds of formats (eg. links to the Styling pages for each type)

Alternatively, these could be 4 subsections under the main Working With Data section, although this would require more levels on the main TOC.

It might make sense for the source directory structure to mirror this organization, but this is not essential if there are issues with doing that (e.g existing URL references)

Thoughts or issues with doing this?

–

Martin Davis
OpenGeo - http://opengeo.org
Expert service straight from the developers.

–

Martin Davis
OpenGeo - http://opengeo.org
Expert service straight from the developers.

Live Security Virtual Conference
Exclusive live event will cover all the ways today’s security and
threat landscape has changed and how IT managers can respond. Discussions
will include endpoint security, mobile security and the latest in malware
threats. http://www.accelacomm.com/jaw/sfrnl04242012/114/50122263/

Geoserver-devel mailing list
Geoserver-devel@anonymised.comsts.sourceforge.net
https://lists.sourceforge.net/lists/listinfo/geoserver-devel

–
Justin Deoliveira
OpenGeo - http://opengeo.org
Enterprise support for open source geospatial.

11

Ok, done. I left the title as “Application Schema Support” - but I can change this if it’s ok with the maintainer.

On Mon, Jun 4, 2012 at 9:29 AM, Justin Deoliveira <jdeolive@anonymised.com> wrote:

Yeah, I think it deserves its own section, there is certainly no shortage of content there! I would maybe put it at the top level under “Working with Application Schemas”.

On Sun, Jun 3, 2012 at 11:49 PM, Martin Davis <mdavis@anonymised.com> wrote:

This reorganization is now committed. Review and comments are welcome.

http://docs.geoserver.org/latest/en/user/data/vector/index.html
http://docs.geoserver.org/latest/en/user/data/raster/index.html
http://docs.geoserver.org/latest/en/user/data/database/index.html
http://docs.geoserver.org/latest/en/user/data/cascaded/index.html

The one remaining issue is what to do with the Application Schema section. It now languishes all alone under the Working With Data
heading. One idea might be to promote it to its own primary section?

http://docs.geoserver.org/latest/en/user/data/index.html

On Mon, Apr 30, 2012 at 3:30 PM, Martin Davis <mdavis@anonymised.com> wrote:

The Working with Data section in the User Guide seems to be getting a bit unwieldy. It might be nice to split it up in a way that highlights the different kinds of data: Vector, Raster, Database, and External Services.

Here’s a proposal for a new structure, which replaces the current section with 4 new ones:

Working with Vector Data

Shapefile
Directory of spatial files
GML
VPF
Java Properties
Pregeneralized Features

Working with Raster Data

ArcGrid
GeoTIFF
GTOPO30
ImageMosaic
WorldImage

GDAL Image Formats
ImagePyramid
Image Mosaic JDBC
Oracle Georaster
Custom JDBC Access for image data

Working with Databases

PostGIS
Oracle
Microsoft SQL Server and SQL Azure

DB2
H2
MySQL

Teradata
ArcSDE
Database Connection Pooling
SQL Views
Controlling feature ID generation in spatial databases
Custom SQL session start/stop scripts
Using SQL session scripts to control authorizations at the database level
Application Schema Support
JNDI

Working with External Data

External Web Feature Server
External Web Map Server

The only new content would be the index page for each new section. This will be a convenient place to put any general advice about working with the different kinds of formats (eg. links to the Styling pages for each type)

Alternatively, these could be 4 subsections under the main Working With Data section, although this would require more levels on the main TOC.

It might make sense for the source directory structure to mirror this organization, but this is not essential if there are issues with doing that (e.g existing URL references)

Thoughts or issues with doing this?

–

Martin Davis
OpenGeo - http://opengeo.org
Expert service straight from the developers.

–

Martin Davis
OpenGeo - http://opengeo.org
Expert service straight from the developers.

Live Security Virtual Conference
Exclusive live event will cover all the ways today’s security and
threat landscape has changed and how IT managers can respond. Discussions
will include endpoint security, mobile security and the latest in malware
threats. http://www.accelacomm.com/jaw/sfrnl04242012/114/50122263/

Geoserver-devel mailing list
Geoserver-devel@lists.sourceforge.net
https://lists.sourceforge.net/lists/listinfo/geoserver-devel

–
Justin Deoliveira
OpenGeo - http://opengeo.org
Enterprise support for open source geospatial.

–

Martin Davis
OpenGeo - http://opengeo.org
Expert service straight from the developers.

12

Martin,

please go ahead and change the title of the app-schema section to "Working with Application Schemas" so that it is consistent with the other sections.

Thanks for this reorganisation. It is a definite improvement, and much appreciated.

Kind regards,
Ben.

On 05/06/12 05:28, Martin Davis wrote:

Ok, done. I left the title as "Application Schema Support" - but I can change this if it's ok with the maintainer.

On Mon, Jun 4, 2012 at 9:29 AM, Justin Deoliveira<jdeolive@anonymised.com<mailto:jdeolive@anonymised.com>> wrote:
Yeah, I think it deserves its own section, there is certainly no shortage of content there! I would maybe put it at the top level under "Working with Application Schemas".

On Sun, Jun 3, 2012 at 11:49 PM, Martin Davis<mdavis@anonymised.com<mailto:mdavis@anonymised.com>> wrote:
The one remaining issue is what to do with the Application Schema section. It now languishes all alone under the Working With Data
heading. One idea might be to promote it to its own primary section?

--
Ben Caradoc-Davies <Ben.Caradoc-Davies@anonymised.com>
Software Engineer
CSIRO Earth Science and Resource Engineering
Australian Resources Research Centre

13

This is great, Martin. A huge improvement, and definitely needed. Thanks!

Thanks,
Mike Pumphrey
OpenGeo - http://opengeo.org

On 6/3/2012 10:49 PM, Martin Davis wrote:

This reorganization is now committed. Review and comments are welcome.

http://docs.geoserver.org/latest/en/user/data/vector/index.html
http://docs.geoserver.org/latest/en/user/data/raster/index.html
http://docs.geoserver.org/latest/en/user/data/database/index.html
http://docs.geoserver.org/latest/en/user/data/cascaded/index.html

The one remaining issue is what to do with the Application Schema section.
  It now languishes all alone under the Working With Data
heading. One idea might be to promote it to its own primary section?

http://docs.geoserver.org/latest/en/user/data/index.html

On Mon, Apr 30, 2012 at 3:30 PM, Martin Davis<mdavis@anonymised.com> wrote:

The Working with Data section in the User Guide seems to be getting a bit
unwieldy. It might be nice to split it up in a way that highlights the
different kinds of data: Vector, Raster, Database, and External Services.

Here's a proposal for a new structure, which replaces the current section
with 4 new ones:

Working with Vector Data

Shapefile
Directory of spatial files
GML
VPF
Java Properties
Pregeneralized Features

Working with Raster Data

ArcGrid
GeoTIFF
GTOPO30
ImageMosaic
WorldImage
GDAL Image Formats
ImagePyramid
Image Mosaic JDBC
Oracle Georaster
Custom JDBC Access for image data

Working with Databases

PostGIS
Oracle
Microsoft SQL Server and SQL Azure
DB2
H2
MySQL
Teradata
ArcSDE
Database Connection Pooling
SQL Views
Controlling feature ID generation in spatial databases
Custom SQL session start/stop scripts
Using SQL session scripts to control authorizations at the database level
Application Schema Support
JNDI

Working with External Data

External Web Feature Server
External Web Map Server

The only new content would be the index page for each new section. This
will be a convenient place to put any general advice about working with the
different kinds of formats (eg. links to the Styling pages for each type)

Alternatively, these could be 4 subsections under the main Working With
Data section, although this would require more levels on the main TOC.

It might make sense for the source directory structure to mirror this
organization, but this is not essential if there are issues with doing that
(e.g existing URL references)

Thoughts or issues with doing this?

--
Martin Davis
OpenGeo - http://opengeo.org
Expert service straight from the developers.

------------------------------------------------------------------------------
Live Security Virtual Conference
Exclusive live event will cover all the ways today's security and
threat landscape has changed and how IT managers can respond. Discussions
will include endpoint security, mobile security and the latest in malware
threats. http://www.accelacomm.com/jaw/sfrnl04242012/114/50122263/

_______________________________________________
Geoserver-devel mailing list
Geoserver-devel@lists.sourceforge.net
https://lists.sourceforge.net/lists/listinfo/geoserver-devel

14

Done!

On Mon, Jun 4, 2012 at 9:07 PM, Ben Caradoc-Davies <Ben.Caradoc-Davies@anonymised.com> wrote:

Martin,

please go ahead and change the title of the app-schema section to “Working with Application Schemas” so that it is consistent with the other sections.

Thanks for this reorganisation. It is a definite improvement, and much appreciated.

Kind regards,
Ben.

On 05/06/12 05:28, Martin Davis wrote:

Ok, done. I left the title as “Application Schema Support” - but I can change this if it’s ok with the maintainer.

On Mon, Jun 4, 2012 at 9:29 AM, Justin Deoliveira<jdeolive@anonymised.comorgmailto:[jdeolive@anonymised.com96...org](mailto:jdeolive@anonymised.com)> wrote:

Yeah, I think it deserves its own section, there is certainly no shortage of content there! I would maybe put it at the top level under “Working with Application Schemas”.

On Sun, Jun 3, 2012 at 11:49 PM, Martin Davis<mdavis@anonymised.commailto:[mdavis@anonymised.com](mailto:mdavis@anonymised.com)> wrote:

The one remaining issue is what to do with the Application Schema section. It now languishes all alone under the Working With Data
heading. One idea might be to promote it to its own primary section?

–
Ben Caradoc-Davies Ben.Caradoc-Davies@anonymised.com
Software Engineer
CSIRO Earth Science and Resource Engineering
Australian Resources Research Centre

–

Martin Davis
OpenGeo - http://opengeo.org
Expert service straight from the developers.