I could remove some of my examples and some of the other that have been added since 2015, but I wonder if the page will still be understood by most people without examples?
Perhaps we could move all the examples to a later section, so that the first part is relatively short and to the point? On 4/28/19, Andy Townsend <ajt1...@gmail.com> wrote: > On 28/04/2019 10:43, Joseph Eisenberg wrote: >> Please suggest any improvements to the wording or corrections: >> https://wiki.openstreetmap.org/wiki/Verifiability#Geometry >> > Thanks for trying to improve the documentation, but unfortunately, > trying to add more detail (including specifics about particular tags) > makes the page more complicated and more difficult to understand for new > mappers (who are usually the people I'd point at that page with a DWG > hat on). > > For example, compare the current version of the page with this one from > 2015: > > https://wiki.openstreetmap.org/w/index.php?title=Verifiability&oldid=1141651 > > The 2015 version contains a definition, an example and short "what to > do" and "what not to do" sections. > > The current one simply doesn't do that. Obviously there are 20 edits > since that example that I picked out pretty much at random from 2015, of > which yours is only the last, and the authors of each of those have seen > an edge case that wasn't quite covered by the documentation, which led > to them adding their new section. The problem is that while all of those > extra little bits on their own have value, taken together they do make > the page less useful as a summary of a key concept in OpenStreetMap. > > Maybe what would be better would be to try and reduce the > "Verifiability" page to its original summary status but to break out > some of the detail into linked sub-pages? The whole "geometry" section > would be a good candidate for that (the page already contains an > example, two paragraphs above). Also "story-telling" content such as > "Someone might do this" is probably better elsewhere too. > > Best Regards, > > Andy > > > > > _______________________________________________ > Tagging mailing list > Tagging@openstreetmap.org > https://lists.openstreetmap.org/listinfo/tagging > _______________________________________________ Tagging mailing list Tagging@openstreetmap.org https://lists.openstreetmap.org/listinfo/tagging
