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 <[email protected]> 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 [email protected] http://lists.openstreetmap.org/listinfo/hot
