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

Joseph Eisenberg joseph.eisenberg at gmail.com
Sun Apr 28 12:43:57 UTC 2019


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 <ajt1047 at 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 at openstreetmap.org
> https://lists.openstreetmap.org/listinfo/tagging
>



More information about the Tagging mailing list