[Ica-osgeo-labs] Update on OGC E-Learning material

[Cameron Shorter]

Hi Luis,
You have some good material in place, and a good document structure.
I haven't had time to do much more than a quick skim, but have picked up 
on a couple of things.
(Hopefully you were looking for feedback?)

I'm looking at the WMS Introduction page:
http://54.68.173.163/el/wms/text/basic-main.html

The page is missing a date stamp. It would be useful for a reader to 
know if this page is still current? Possibly add a "Last Updated" tag or 
similar.

Nice idea to have a History section.
This would probably be best structured as a table with:

<version number> <Release date> <Summary of what changed since last release>

Somewhere, probably in a separate document, there should be a detailed 
description listing everything which has changed since the last release.
This will help implementers answer:
* If I upgrade a legacy system to a more recent OGC standard, what extra 
functionality will I gain? What incompatibility issues might be 
encountered, if any?


I like the "Relation to other Standards" section.
It is good to explain why WFS would be used instead of WMS. I suggest it 
would be valuable to explain the opposite as well. Why would you use WMS 
instead of WFS (or instead of WMTS)?

Example:
I notice the example references an external URL ( 
http://metaspatial.net/ ). For OGC branded material, I'd suggest that 
all examples or references maintained on OGC infrastructure, and not 
rely on a third party which may have different terms of service.
In particular, I'd suggest that all training material should make use of 
relative URLs for web services from training material. Ie, instead of 
referencing http://www.opengeospatial.org/<services>/wms.cgi
reference ../../<services>/wms/cgi
That way, the training material, along with all the examples can be 
copied into a virtual machine or similar and used in a classroom, or ...
(We follow this convention with the OSGeo-Live project).

Warm regards,
Cameron

On 27/06/2015 5:55 am, Luis Bermudez wrote:
> All,
>
> We have made some progress developing OGC online training material.
>
> I have updated the wiki to reflect the latest. Here we have the 
> logical groupings we are thinking about in order to make the standards 
> easier to digest and explain, and maybe in the future to provide 
> professionals OGC certification.
>
> https://github.com/opengeospatial/e-learning/wiki/Content
>
>
> The source [1] should be easily reusable. We have design it in a way 
> that the documentation can be easily incorporated in other places 
> (e.g. OCG Live).
>
> For example
>
> - introduction to OGC can be found here in the intro-ogc.rst file [2]
> - introduction to WMS 1.3 [3]
>
> We also have demo server with the content created so far:
>
> http://54.68.173.163/el/
>
> Help, feedback and comments are appreciated.
>
> [1] https://github.com/opengeospatial/e-learning/tree/master/source
> [2] 
> https://github.com/opengeospatial/e-learning/tree/master/source/ogc/text
> [3] 
> https://github.com/opengeospatial/e-learning/blob/master/source/wms/text/basic-main.rst
>
> Enjoy!
>
> Luis Bermudez, Ph.D.
> Executive Director Compliance and E-Learning
> Open Geospatial Consortium (OGC)
> Skype: bermudez_luis
> Twitter: @berdez
> Tel: +1 301 760 7323
> https://www.linkedin.com/in/bermudez
>
> The OGC: Making Location Count
>
>
>
> _______________________________________________
> ica-osgeo-labs mailing list
> ica-osgeo-labs at lists.osgeo.org
> http://lists.osgeo.org/cgi-bin/mailman/listinfo/ica-osgeo-labs

-- 
Cameron Shorter,
Software and Data Solutions Manager
LISAsoft
Suite 112, Jones Bay Wharf,
26 - 32 Pirrama Rd, Pyrmont NSW 2009

P +61 2 9009 5000,  W www.lisasoft.com,  F +61 2 9009 5099

-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.osgeo.org/pipermail/geoforall/attachments/20150628/45c5c9a3/attachment.html>