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

[maning sambale]

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/
------------------------------------------------------