[OSM-talk] Reordering and rewriting Good Practice wiki page

Warin 61sundowner at gmail.com
Thu Jul 4 04:40:34 UTC 2019


On the order of things.

Best to tell them what to do first. This provides some motivation.

Leave 'what not to do' for last, these tend to turn people away.

So I would do:

1	One feature, one OSM element

2	Good changeset comments (+Keep the history)

3	Editing Standards: (Align aerial imagery before tracing, Do not
trace from outdated imagery... Keep straight ways straight ... Mark
estimations with FIXME ... etc.)
  
4	Do correct errors

5	Verifiability (+Map what's on the ground, Don't map: historic
events, temporary features, local legislation etc)

6	Document your custom-tags (Don't remove tags that you don't
understand...

7	Don't map for the renderer (+ Don't misuse name tag)




On 04/07/19 14:15, Joseph Eisenberg wrote:
> As mentioned, I plan to significantly shorten the "Keep the history"
> section, with a link to the longer version at
> https://wiki.openstreetmap.org/wiki/Keep_the_history instead.
>
> I would probably support shortening the page even further, but I've
> already had several edits reverted by other users who are in favor of
> including various sections.
>
> On 7/4/19, Yves <yvecai at mailbox.org> wrote:
>> Hmm... I would be all in favor of extending the See also... section and
>> shorten drastically the page to keep it simple.
>> Some of the good practices there are second order, don't you think?
>> Keeping history compared to Tag for the renderer, for example.
>> Yves
>>
>> Le 4 juillet 2019 05:53:23 GMT+02:00, Joseph Eisenberg
>> <joseph.eisenberg at gmail.com> a écrit :
>>> I've reordered and reworded several sections of the Good practice
>>> page: https://wiki.openstreetmap.org/wiki/Good_practice
>>>
>>> The page had grown over the years from 6 or 7 initial sections:
>>> (First verion of page in 2008
>>> https://wiki.openstreetmap.org/w/index.php?title=Good_practice&oldid=86242)
>>>
>>> 1) Don't map for the renderer
>>> 2) One feature, one OSM-object
>>> 3) Keep straight ways straight
>>> 4) Map what's on the ground
>>> 5)a) Don't remove tags you don't understand
>>>    b) Document your custom-tags
>>> 6) Do correct errors
>>>
>>> Now there were 22 different sections, several added this past year
>>> without discussion, and they were not organized:
>>> https://wiki.openstreetmap.org/w/index.php?title=Good_practice&oldid=1861565
>>>
>>> I've reordered and categorized these sections under 7 main headings:
>>>
>>> 1	Do correct errors
>>> 2	Verifiability (+Map what's on the ground, Don't map: historic
>>> events, temporary features, local legislation etc)
>>> 3	Don't map for the renderer (+ Don't misuse name tag)
>>> 4	Good changeset comments (+Keep the history)
>>> 5	One feature, one OSM element
>>> 6	Editing Standards: (Align aerial imagery before tracing, Do not
>>> trace from outdated imagery... Keep straight ways straight ... Mark
>>> estimations with FIXME ... etc.)
>>> 7	Document your custom-tags (Don't remove tags that you don't
>>> understand...
>>>
>>> I've made some wording changes for more consistent and concise style,
>>> and removed some examples (eg abandoned railways)
>>>
>>> I've removed 2 sections added in the past year:
>>>
>>> "Don't map insignificant, perishable and mobile objects"
>>> - this section duplicated information in the exiting heading about
>>> temporary features
>>>
>>> "Don't censor anything existing in reality for any reason. Avoid
>>> interpolations if there is sufficient imagery."
>>> - This seems redundant and the part about censoring data isn't
>>> completely correct. We don't add personal info about who lives in a
>>> private house, for example.
>>>
>>> While I haven't done this yet, I would also recommend moving the long
>>> details about "Keep the history", involving how to use specific
>>> editors and checking history in certain editors, along with the
>>> section "Check the history of important objects" which duplicates
>>> advice in the Aerial Imagery section, to a new page, with a link:
>>> https://wiki.openstreetmap.org/wiki/Keep_the_history
>>>
>>> Joseph Eisenberg, User:Jeisenbe
>>>
>>> _______________________________________________
>>> talk mailing list
>>> talk at openstreetmap.org
>>> https://lists.openstreetmap.org/listinfo/talk
> _______________________________________________
> talk mailing list
> talk at openstreetmap.org
> https://lists.openstreetmap.org/listinfo/talk





More information about the talk mailing list