[Tagging] Verifiability wiki page: "Geometry" section added

Andy Townsend ajt1047 at gmail.com
Sun Apr 28 12:20:55 UTC 2019


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






More information about the Tagging mailing list