[HOT] Starting work on the Advance materials of learnOSM.org

Fri Jul 5 12:50:36 UTC 2013

Hi Mikel,

The current advanced training was specifically designed for a workshop
we were going to give in Indonesia. We never gave the workshop because
the materials were a bit too complicated for our audience. We changed
the entire training to be more of a Train the Trainer, which isn't up
online yet.

Also there is an intermediate section which needs a little more
clean-up but there is an active pull request.

Best,

-Kate

On Fri, Jul 5, 2013 at 7:10 PM, Mikel Maron <mikel_maron at yahoo.com> wrote:
> Hi Maning
>
> Thank you for picking this up and pushing on it. So valuable.
>
> I have a bit of feedback on the content. If this isn't what you're looking
> for right now, let's keep on the backburner. But here's my responses to
> looking through the advanced guide now.
>
> First, the division into "Beginner" and "Advanced" seems a little
> artificial. The "Beginner" section makes sense, but for more advanced
> topics, to me it makes more sense to group topically, and indicate level of
> difficulty as an attribute of each section. For instance "More on Editing"
> (Editing in Detail, Presets, Private Data Store), Coordination (Tasking
> Server, Quality Control, Editing the Wiki), Sharing and Map Production
> (TileMill, github, maps on a website, WMS), and Sys Admin (postgres set up,
> virtural machine set up).
>
> I'd also add a section to dealing with extracts and data products ... ie
> finding stuff on GeoFabrik, using Overpass Turbo, etc. Also perhaps more on
> advanced tag development ... what do you do when your tag doesn't exist?
> That seems a more natural purpose for the section on editing the wiki. Might
> also want to add a section on producing tiles, but simply link to
> switch2osm.org
>
> I suggest Potlatch2 guide be updated to iD, only. I also have some material
> on more configuration of the GPS, and surveying tips, to contribute. And for
> the OrbView imagery, does it make sense to talk more generally about dealing
> with imagery, with OrbView as an example?
>
> Thanks
> Mikel
>
>
> * Mikel Maron * +14152835207 @mikel s:mikelmaron
>
> ________________________________
> From: maning sambale <emmanuel.sambale at gmail.com>
> To: HOT <hot at openstreetmap.org>
> Sent: Friday, July 5, 2013 12:03 PM
> Subject: Re: [HOT] Starting work on the Advance materials of learnOSM.org
>
> Dear HOTties,
>
> Following-up on our plan to update learnOSM.org materials [0].
> I talked to Kate and Emir discussing the updating of materials and was
> advised to raise this to the HOT list.
>
> Anyway, our proposed work is to first move all the English learning
> guides to MarkDown.
> The initial work on the Advance section is waiting review [2].  Can
> someone have a look and give us advise if
> the work is OK?
>
> Planned next steps are:
> 1. Improve existing content.
> 2. Add new content.
> 3. Fix things listed in the issue queue.
>
> Some questions:
> 1. Style guide for consistent formatting and tone [3]. I propose we
> use some of the guidelines from
> Python [4] and Geoserver [5] as starting point (this is for the EN
> materials, other languages maybe different).
>
> 2. Print friendly output [6].  The all-chapters (with images) is good
> enough for printing.  But for our planned
> training events, we would like something like a printed paper manual
> (with some nice cover page and TOCs).
> We usually do this using Sphinx' PDF output [7].  However, we would
> like to avoid reformatting everything again
> for compiling in Sphinx.  Are there automated ways to do this?
>
> 3. What other sections should be added? There are several proposed [8,
> 9 and 10].
>
> Finally, I want to ask the overall usefulness (I'm sure it is) of the
> learnosm.org especially for conducting
> mapping workshops and give us advise on improvements.
>
> Thanks!
> -----
>
> [0] http://lists.openstreetmap.org/pipermail/hot/2013-June/003235.html
> [1] https://github.com/hotosm/learnosm/wiki/English-Learning-Guides
> [2] https://github.com/hotosm/learnosm/pull/103
> [3] https://github.com/hotosm/learnosm/issues/82
> [4] http://docs.python.org/devguide/documenting.html#style-guide
> [5] http://geoserver.org/display/GEOS/Documentation+Style+Guide
> [6] https://github.com/hotosm/learnosm/issues/56
> [7] http://sphinx-doc.org/
> [8] https://github.com/hotosm/learnosm/issues/76
> [9] https://github.com/hotosm/learnosm/issues/61
> [10] https://github.com/hotosm/learnosm/issues/98
>
> On Mon, Jun 17, 2013 at 6:52 PM, maning sambale
> <emmanuel.sambale at gmail.com> wrote:
>> Dear everyone,
>>
>> We are starting work on the Advance chapters for the learnOSM.org.  We
>> decided to start on the Advance guides because there is pending work
>> for merging in the Intermediate guides by the HOT Id team [0].
>>
>> Our plan is to first convert all chapters to markdown and then start
>> revising some of them and later add new sections in either the
>> beginner, intermediate or advance guide.
>>
>> Improving the layout for markdown will continue within the week.  I
>> submitted an issue ticket to track the progress [1] in my own fork.  I
>> would also like for others to have a quick review of our progress so
>> far before submitting a pull request.
>>
>> Thanks!
>>
>> [0] https://github.com/hotosm/learnosm/pull/100
>> [1] https://github.com/hotosm/learnosm/issues/102
>>
>> --
>> cheers,
>> maning
>> ------------------------------------------------------
>> "Freedom is still the most radical idea of all" -N.Branden
>> wiki: http://esambale.wikispaces.com/
>> blog: http://epsg4253.wordpress.com/
>> ------------------------------------------------------
>
>
>
> --
> cheers,
> maning
> ------------------------------------------------------
> "Freedom is still the most radical idea of all" -N.Branden
> wiki: http://esambale.wikispaces.com/
> blog: http://epsg4253.wordpress.com/
> ------------------------------------------------------
>
> _______________________________________________
> HOT mailing list
> HOT at openstreetmap.org
> http://lists.openstreetmap.org/listinfo/hot
>
>
>
> _______________________________________________
> HOT mailing list
> HOT at openstreetmap.org
> http://lists.openstreetmap.org/listinfo/hot
>