[OSM-talk] Improving ref=* documentation

[François Lacombe]

Hi Tobias

Le sam. 7 août 2021 à 18:19, Tobias Knerr <osm at tobias-knerr.de> a écrit :

> On 04.08.21 20:33, François Lacombe wrote:
> > Here is this little draft of to-be w/References page.
> > https://wiki.openstreetmap.org/wiki/User:Fanfouer/References
> >
> > Some points may sounds obvious but It's better written, particularly
> > when on boarding new mappers or consumers.
>
> When a topic is already documented on the wiki, my feeling is that
> creating _additional_ wiki pages about the topic with similar but
> slightly different content is often not going to help beginners.
>
> Duplication means that there's now a larger amount of text to read
> through, and people tend to be confused about which page is the more
> correct/current one. It's common to end up with contradictions or stale
> pages at some point because people are far more willing to add text to
> the wiki than they are to update or delete it.
>

It's ok to improve Key:ref with specific references chapter and general
information at the beginning of my draft.
It's also ok to create a more specific page regarding update tracking with
help of references in OSM, instead of variable osm ids.

We will have to discuss about the relevancy of reg_ref, unsigned_ref,
local_ref and so on...
To me, with the help of specific refs (ref:FR:*, ref:*...) properly
documented with extensive validation rules, they aren't required any more.
Given problem it's hard to document reg_ref with local rules between
countries for instance, while it's more appropriate with ref:* keys.

Maybe a formal proposal page will finally be necessary about that.

All the best

François
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.openstreetmap.org/pipermail/talk/attachments/20210809/85a14ea4/attachment.htm>