Join GitHub today
GitHub is home to over 28 million developers working together to host and review code, manage projects, and build software together.Sign up
Backport materials and illustrations to JOSM wiki? #162
There a number of concerns why I'm suggesting this:
I mean, it would be nice to describe JOSM in one place, not in every individual company: a correct, but incomplete guides - probably not what we want for our users/mappers. As far as I can see, It doesn't matter what is target audience: a Mapbox employee or a real mapper, one day they will need exhaustive info on some topic: how to correct validation errors
I haven't seen a single guide that explains status bar as well as is it should: https://josm.openstreetmap.de/wiki/Help/StatusBar or a search interface: https://josm.openstreetmap.de/wiki/Help/Action/Search or expert mode https://josm.openstreetmap.de/wiki/Help/ExpertMode
@d1g thanks for bringing this up. Lets be very clear that the intention of these mapping guides is not to replace the JOSM wiki which is the right source for the latest software documentation.
These mapping guides are just a condensed version of all the existing guidelines and best practices for ease of access for our data team internally.
All the material is cc-0, so please feel to reuse/backport any of the materials to update the JOSM/OSM wiki. Let us know how we can assist to make this easier
Plugins are not documented: simply install some plugin, hover mouse over button(s) on the left or main menu items (top) and then press F1.
If there no help, then it means something should be written here (within embedded browser: button in top right corner used to edit wiki page using browser).
If we were documenting tools this way, then we could simplify all instructions to: 1. here is first edit guide, 2. if you have questions about JOSM - press F1 over element 3. custom tasks are here ...
@planemad I thank you very much for your effort on this, however I think you are avoiding @d1g concern with this. Yes you say this is your 'internal guide/best practice' but at the same time you have invested time and resources to summarise and condense the best practice in the osm world. I would think that the wiki would be the better place to reach more mappers and spread adoption and knowledge of these best practices.
Re-documenting (say, JOSM features) is wrong, but combining right subset of links to a complete JOSM documentation - is correct. Improving navigation within JOSM wiki - is also correct (consider using feature X when you are using B, D but A is not available).
As bad example I would use http://learnosm.org that forces you to read about fieldpapers and GPS, but neither of them is necessary or required to start OSM contribution. People who use field pappers and GPS when imagery is available and was traced by local mappers are horribly under-perform in mapping. With dense infrastructure and many objects you will need photos and video.
It is faster to take a photo or vidoe, then to capture data using pen & paper.
When we talk about "best practice" (say, lanes), there a page about it at wiki: https://wiki.openstreetmap.org/wiki/Lanes. Based on edit history, I can say that it wasn't expanded as well as it should: 1 2
Some of information is US-only, but we can use region-specific paragraphs (similar to this page)
PS. I'm happy that we could simply reuse what Mapbox(ers) did for themselves without need to worry about license compliance and all that legal nonsense