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
