Dear Mikel, Thanks for all the suggestions. Will bite into some of the ideas bit-by-bit.
On Fri, Jul 5, 2013 at 8:10 PM, Mikel Maron <[email protected]> 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 <[email protected]> > To: HOT <[email protected]> > 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 > <[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 > > -- 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
