[Ica-osgeo-labs] Documenting OGC standards and OGC standards training
Cameron Shorter
cameron.shorter at gmail.com
Fri Mar 27 13:36:37 PDT 2015
Hi Luis,
It is good to hear that OGC Standard Overviews from OSGeo-Live material
is being considered as a starting point for OGC Standard documentation.
Also good to hear that training modules are being developed. I assume
that these will be 2 different types of documentation, serving different
purposes?
Over the last few days I've been researching existing material
describing OGC standards, with the aim of helping define a template for
created documentation, and a process/pipeline for developing and
publishing material.
I've found that wikipedia has quite a bit of material which we could
draw upon. Eg, there are descriptions of most of the OGC standards [1].
Wikipedia also has an excellent collaborative development process,
including a translation pipeline.
Wikipedia has a concept of "Style Guidelines" which can be applied to
different categories. As yet, a "Style Guideline" has not been set for
OGC Standards, and as such, we could define one. (I can't find a decent
style guide for ISO standards, which might be worth discussing with ISO).
I'd suggest that:
* Wikipedia should be one of our target delivery formats for our "1 page
overview" documents.
* As such, we should adopt wikipedia writing conventions to make this
simpler.
* Other delivery locations should be OGC web pages, and OSGeo-Live
documentation pages.
* The OGC pages (and to a lesser extend OSGeoLive pages) need to be
considered as an authoritative source, and as such should have a trusted
OGC editorial review before publishing.
I'm open to Luis' suggestion of developing overview pages in git, but
suggest it might be better to develop in wikipedia as:
0. Define a Wikipedia "Style Guideline" for OGC Standards.
1. Collaboratively develop Overviews in Wikipedia
1.1 OGC provide Authoritative Review back into Wikipedia, then publish
to OGC pages as authoritative source. (This might involve copying across
into an OGC git repository)
1.2 OSGeo-Live copies these pages into OSGeo-Live docs
2. Translations coordinated through Wikipedia
I'll save my ideas about content of Overview docs for another email.
[1] http://en.wikipedia.org/wiki/Web_Map_Service
[2] http://en.wikipedia.org/wiki/Wikipedia:Manual_of_Style/Layout
On 27/03/2015 4:09 am, Luis Bermudez wrote:
> Hi Cameron,
>
> You were missed in the telecon.
>
> Angelos provided great information on the resources that exists in
> OSGeo-Live. I'm wondering how to better contribute and reuse what is
> at the OSGeo-Live.
>
> For example, will this make sense:
> We fork some of the content from OSGeo-Live repository, make the
> changes/additions and then you pull from the OGC repository
>
> Or?
>
>
> - Luis
>
> ---------------------------------------------------
> Luis Bermudez, Ph.D.
> Executive Director Compliance and E-Learning
> Open Geospatial Consortium (OGC)
> The OGC: Making Location Count
>
> Skype: bermudez_luis
> Twitter: @berdez
> Tel: +1 301 760 7323
> http://www.opengeospatial.org/ogc/organization/staff/lbermudez
>
>
>
>
> On Mar 18, 2015, at 5:43 PM, Cameron Shorter
> <cameron.shorter at gmail.com <mailto:cameron.shorter at gmail.com>> wrote:
>
>> Hi, I'm keen, but not keen enough to wake up at 2am/3am (for
>> Sydney/Australia timezone).
>>
>> Happy to contribute by email before/afterwards.
>>
>> Alternatively, I can make this timeslot:
>> http://www.timeanddate.com/worldclock/meetingdetails.html?hour=19&min=30&sec=0&p1=179&p2=189&p3=224&p4=22&p5=240&p6=196&p7=215
>>
>> On 18/03/2015 12:40 am, Luis Bermudez wrote:
>>> All,
>>>
>>> For those of you interested to discuss the next steps about how to
>>> better develop and share E-Learning resources for OGC standards, I
>>> have created a doodle poll. Note that the times are in Eastern Time.
>>> http://doodle.com/w5sr533xn95ryswu7c9s59mk/admin#table
>>>
>>> I will also invite folks from the OGC University Domain Working group.
>>>
>>>
>>>
>>> I will send the logistics of the meeting after we have settle on the
>>> date and time.
>>>
>>> Looking forward to a great discussion.
>>>
>>> Best Regards,
>>>
>>> - Luis
>>>
>>> ---------------------------------------------------
>>> Luis Bermudez, Ph.D.
>>> Executive Director Compliance and E-Learning
>>> Open Geospatial Consortium (OGC)
>>> The OGC: Making Location Count
>>>
>>> Skype: bermudez_luis
>>> Twitter: @berdez
>>> Tel: +1 301 760 7323
>>> http://www.opengeospatial.org/ogc/organization/staff/lbermudez
>>>
>>>
>>>
>>>
>>> On Mar 17, 2015, at 3:07 AM, Suchith Anand
>>> <Suchith.Anand at nottingham.ac.uk
>>> <mailto:Suchith.Anand at nottingham.ac.uk>> wrote:
>>>
>>>> Hi Luis,
>>>>
>>>> That is excellent. Let us schedule a telecon to discuss next steps.
>>>> May i suggest that you send a doodle poll with your convenient
>>>> times to this list and we can then find a best time suitable for
>>>> all.Thanks.
>>>>
>>>> Best wishes,
>>>>
>>>> Suchith
>>>>
>>>>
>>>> ________________________________________
>>>> From: Luis Bermudez [lbermudez at opengeospatial.org
>>>> <mailto:lbermudez at opengeospatial.org>]
>>>> Sent: Monday, March 16, 2015 10:32 PM
>>>> To: Cameron Shorter; Suchith Anand
>>>> Cc: Christopher Tucker; George Percivall; Carl Reed;
>>>> ica-osgeo-labs at lists.osgeo.org <mailto:ica-osgeo-labs at lists.osgeo.org>
>>>> Subject: Re: [Ica-osgeo-labs] Documenting OGC standards and OGC
>>>> standards training
>>>>
>>>> Hi Suchith, Cameron and all,
>>>>
>>>> I'm very happy to see this dialog.
>>>>
>>>> Now that I have been officially appointed (tasked), I want to
>>>> leverage, contribute and help move forward e-learning material
>>>> related to OGC standards.
>>>>
>>>> I'm wondering, is it worth to schedule a telecon about the next steps?
>>>>
>>>> Best Regards.
>>>>
>>>> - Luis
>>>>
>>>> ---------------------------------------------------
>>>> Luis Bermudez, Ph.D.
>>>> Executive Director Compliance and E-Learning
>>>> Open Geospatial Consortium (OGC)
>>>> The OGC: Making Location Count
>>>>
>>>> Skype: bermudez_luis
>>>> Twitter: @berdez
>>>> Tel: +1 301 760 7323
>>>> http://www.opengeospatial.org/ogc/organization/staff/lbermudez
>>>>
>>>>
>>>>
>>>>
>>>> On Mar 15, 2015, at 4:49 AM, Cameron Shorter
>>>> <cameron.shorter at gmail.com> wrote:
>>>>
>>>>> Forwarding on Chris' email (with permission), which bounced from
>>>>> this list.
>>>>>
>>>>> Thanks Chris for the offer of support from yourself and others
>>>>> from the OGC. I think this is another great opportunity for OSGeo
>>>>> and the OGC to work together.
>>>>> It is also very valuable and motivating for us OSGeo contributors
>>>>> to know that the OGC can help deliver OSGeo concerns to the right
>>>>> people.
>>>>>
>>>>> Regards, Cameron
>>>>>
>>>>> On 15/03/2015 8:06 am, Christopher Tucker wrote:
>>>>>> Cameron,
>>>>>>
>>>>>> As an OGC Board member, I appreciate the subject change. If the
>>>>>> GeoForAll community wants any particular involvement from the OGC
>>>>>> on this or other matters, I am more than happy to help facilitate
>>>>>> the interaction with appropriate OGC staff and membership.
>>>>>>
>>>>>> Also, coincidently, I happen to do a lot of work with leading US
>>>>>> government investors in LiDAR technology, collection and
>>>>>> processing - all the way up to the White House Office of Science
>>>>>> and Technology Policy. If their attention is required, I am
>>>>>> happy to facilitate.
>>>>>>
>>>>>> Thanks for all you guys are doing.
>>>>>>
>>>>>> Chris
>>>>>> 703-981-9373
>>>>>>
>>>>>>
>>>>>>
>>>>>>
>>>>>>> On Mar 14, 2015, at 4:36 PM, Cameron Shorter
>>>>>>> <cameron.shorter at gmail.com> wrote:
>>>>>>>
>>>>>>> I'm bringing this email thread back onto the public
>>>>>>> ica-osgeo-labs list (CC OGC people) and changing title (with
>>>>>>> permission of Suchith).
>>>>>>> Title was "RE: [Ica-osgeo-labs] The LAS format, the ASPRS, and
>>>>>>> the ģLAZ cloneē by ESRI" and a private conversation had started.
>>>>>>>
>>>>>>> Hi Suchith,
>>>>>>> I like the idea of bringing OGC standards into education, and
>>>>>>> would be keen to see authoritative and consistent descriptions
>>>>>>> of standards available. (We started doing this a while ago on
>>>>>>> OSGeo Live [1], but these descriptions are incomplete, out of
>>>>>>> date, and the template needs improving).
>>>>>>>
>>>>>>> There was further discussion about describing standards within
>>>>>>> the OGC "Ideas4OGC" initiative [2] ~ October 2013, leading to
>>>>>>> recognition of a need for consistent descriptions of standards:
>>>>>>> including a one pager description for architects, and an
>>>>>>> implementation guide for developers.
>>>>>>>
>>>>>>> There is a lot of work in developing such documentation for all
>>>>>>> standards, but if we create a template for what is required, we
>>>>>>> can then spread the work across multiple interested parties (as
>>>>>>> we have done with OSGeo-Live documentation). I'd be happy to
>>>>>>> help with creating such a template.
>>>>>>>
>>>>>>> [1] http://live.osgeo.org/en/standards/standards.html
>>>>>>> [2]
>>>>>>> http://external.opengeospatial.org/twiki_public/Ideas4OGC/InitialRecommendations#Topic_20:_Quality_versus_Quantity
>>>>>>> and
>>>>>>> http://external.opengeospatial.org/twiki_public/Ideas4OGC/InitialRecommendations#Topic_28:_Active_Direction
>>>>>>>
>>>>>>>> On 13/03/2015 8:30 pm, Suchith Anand wrote:
>>>>>>>> Hi Cameron, All,
>>>>>>>>
>>>>>>>> I am not a standards expert but i am determined that i am going
>>>>>>>> to do my best to improve the education aspects of Open
>>>>>>>> Standards in Geo Eduation curriculum worldwide. This is long
>>>>>>>> term action and we need help from all interested to join this.
>>>>>>>>
>>>>>>>> We have done this successfully in Open Source GIS education in
>>>>>>>> a very short time. For example, our GeoAcademy colleagues have
>>>>>>>> not only established a very successful MOOC program ( i
>>>>>>>> understand over 4000 students are enrolled for their March 2015
>>>>>>>> cohort, so the scale of expansion of this amazing) but more
>>>>>>>> importantly they made available the curriculum (lecture
>>>>>>>> materials, tutorials etc) available to all educators to share
>>>>>>>> and share alike under the Creative Commons BY 3.0 license at
>>>>>>>> the GitHub repository at https://gi
>>>>>
>>>>> --
>>>>> 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
>>>>>
>>>>> _______________________________________________
>>>>> ica-osgeo-labs mailing list
>>>>> ica-osgeo-labs at lists.osgeo.org
>>>>> http://lists.osgeo.org/cgi-bin/mailman/listinfo/ica-osgeo-labs
>>>>
>>>>
>>>>
>>>>
>>>>
>>>> This message and any attachment are intended solely for the addressee
>>>> and may contain confidential information. If you have received this
>>>> message in error, please send it back to me, and immediately delete
>>>> it.
>>>>
>>>> Please do not use, copy or disclose the information contained in this
>>>> message or in any attachment. Any views or opinions expressed by the
>>>> author of this email do not necessarily reflect the views of the
>>>> University of Nottingham.
>>>>
>>>> This message has been checked for viruses but the contents of an
>>>> attachment may still contain software viruses which could damage your
>>>> computer system, you are advised to perform your own checks. Email
>>>> communications with the University of Nottingham may be monitored as
>>>> permitted by UK legislation.
>>>>
>>>
>>
>> --
>> 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, Wwww.lisasoft.com, F +61 2 9009 5099
>
--
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/20150328/0eeaf15b/attachment.html>
More information about the GeoForAll
mailing list