NL:Good changeset comments

From OpenStreetMap Wiki
Jump to navigation Jump to search

Wat is een opmerking voor een wijzigingenset?

Een Wijzigingenset is een groep bewerkingen die door één gebruiker in relatief korte tijd na elkaar zijn gemaakt.

Wanneer u een wijzigingenset uploadt, zal de bewerker die u gebruikt u een kans geven om een beschrijving van de wijzigingenset in te voeren - hieronder zijn respectievelijk Potlatch en JOSM weergegeven:

ChangesetComment-Potlatch-English.png ChangesetComment-JOSM-English.png

De opmerking die u hier invult, zal in een aantal situaties naast de bewerking die u heeft uitgevoerd zichtbaar zijn, bijvoorbeeld als iemand door de geschiedenis van een object bladert of alle wijzigingen bekijkt die betrekking hebben op een gebied.

Waarom zou ik opmerkingen voor wijzigingensets moeten gebruiken?

Er zijn vele redenen waarom u gebruik zou moeten maken van de opmerkingen voor wijzigingenset om uw bewerkingen te omschrijven:

  • Uit respect voor uw collega mappers, omdat u het voor hen eenvoudiger maakt om te begrijpen wat u heeft gedaan en waarom. Geen opmerking voor wijzigingenset gebruiken heeft iets van "het gaat niemand wat aan wat ik deed en waarom" en past niet echt binnen een project waar we allemaal aan hetzelfde werken!
  • Om misverstanden te vermijden en fouten snel te kunnen herstellen - indien een bewerking met de opmerking voor wijzigingenset als "een aantal huizen opgespoord vanaf Bing" 50 restaurants verwijderd dan is het onmiddellijk duidelijk dat dat een fout moet zijn geweest, terwijl een opmerking voor wijzigingenset als "restaurants verwijderd die gesloten zijn en die ik vond toen ik daar de afgelopen week naar heb gekeken" duidelijk maakt dat u echt van plan was om deze restaurants te verwijderen en met een goede reden.
  • Om de waarde van uw bewerking te vergroten en discussies over bewerkingen te voorkomen door uit te leggen waarom u iets deed en wat uw bronnen waren. Als men vindt dat u een huis hebt toegevoegd dat niet zichtbaar is op hun luchtfoto's, kunnen zij in de verleiding komen om het te verwijderen, maar als uw opmerking voor wijzigingenset vermeldt "nieuw opgericht gebouw toegevoegd" dan zouden zij zich nog wel eens kunnen bedenken!
  • Als een geheugensteuntje. Opmerkingen voor wijzigingensets helpen u te onthouden wat u deed, en waarom en wanneer. Onthoud dat het 6 maanden of 1 jaar verder kan zijn voordat u de informatie in de opmerkingen nodig hebt, en het is moeilijk te voorspellen wanneer u een oude bewerking nodig heeft. Kortom: Eat your own dogfood!

Sommige mappers gebruiken ook de opmerking voor wijzigingenset om dingen te vermelden die zij *niet*, of nog niet, hebben gedaan ("... maar hier moet nog iets aan gedaan worden", "... maar gebied ten westen van de rivier ontbreekt nog" of zoiets).

Er zijn situaties waar het evident is waar de wijzigingenset over gaat - speciaal als het slechts één enkel object betreft - maar deze situaties zijn minder algemeen dan u misschien denkt. Als u een typefout hebt gecorrigeerd, maakt de opmerking voor de wijzigingenset "fixed typo" nog steeds duidelijk dat dat precies was wat u van plan was, in plaats van dat uw kat weer eens over het toetsenbord liep!


Voorbeelden

Een goede opmerking voor wijzigingenset zou nauwgezet en adequaat een bewerking moeten beschrijven. Echte voorbeelden van goede opmerkingen voor wijzigingenset omvatten:

  • "Updating Danish street addresses from OSAK (AWS): Bag Hegnet"
  • "Achtung: Die gelöschten Gebäude wurden Ende 2010 abgerissen. Bitte nicht wieder einzeichnen!!!"
    • (Duits voor: "Attentie, de verwijderde gebouwen zijn eind 2010 gesloopt, voeg ze alstublieft niet opnieuw toe")
  • "Add a footpath link from Donnington Close to Roman Way based on local knowledge"
  • "Updated Algonquin Park boundary"
  • "Add country roads and cycleway SE of Newport"
  • "Köln: Nicht-Kreisverkehre, 'junction=roundabout' entfernt, Vz 215 nicht vorhanden" (Duits voor "Keulen: Verwijderd junction=roundabout uit non-roundabouts, verkeersbord 215 is niet aanwezig")
  • "added a few tidal inlets to the coastline of Maranhão"
  • "Added buildings in industrial area."
  • "Bike route Stora Vargleden. Roads and paths in Tiveden."
  • "Added details in Upper Ferntree Gully - Montrose Victoria, Australia from bing and survey following redaction bot."
  • "Updated roads near Wolf Lake Bemiji MN based on satellite photos."
  • "Added Hawthorn Pond Natural area (Holland Twp. MI), its pathways and amenities."
  • "Correct pier border for LSO harbour"
  • "Added houses and house numbers based on Bing and local knowlege. Some house numbers could sadly not be found."

Sommige opmerkingen voor wijzigingensets zijn onbruikbaar en brengen niet de voordelen die een opmerking voor wijzigingenset kan bieden - opnieuw echte voorbeelden:

  • "BBOX:3.23,41.96,3.23,41.96 ADD:14 UPD:0 DEL:0"
  • "Edit uploaded via ArcGIS Editor for OpenStreetMap feature service dec20 at 1/13/2012 9:56:00 AM"
  • "some fixes"
  • "additions to map"
  • "--"

Maar er zijn opmerkingen die nog erger dan onbruikbaar zijn - opnieuw echte voorbeelden:

  • "Can the idiots who code this stuff please learn to give useful error messages."
  • "F*** Potlach2, tired of fixing the after effects of this bug"
  • "F*** Merkaartor SVN."
  • "dfshksdhkhksdfhkasf (stupid JOSM requirement)"
  • "Warum ich wann wo war geht niemand dritten etwas an." (Duits voor: "Waar ik was en waarom en wanneer gaat niemand iets aan")

Onthoudt alstublieft dat uw opmerkingen voor wijzigingensets net zo lang in de database blijven als dat het project voortduurt; gebruik ze niet om uw woede over software te uiten of over uw collega mappers die u misschien hebben gezegd iets te repareren, of vragen hebben gesteld omtrent uw bronnen.

Voorzichtig bij toevoegen aan bestaande wijzigingenset

Wanneer u een wijzgingenset upload en een beschrijving van de wijzigingenset specificeert, sluit de bewerker niet altijd onmiddellijk de wijzigingenset en kunnen daarop volgende bewerkingen worden toegevoegd aan dezelfde wijzigingenset en daarom dezelfde opmerking voor wijzigingenset delen.

Indien u één bewerking hebt voltooid en met iets anders begint, zorg er dan voor dat dat "iets anders" wordt opgenomen in een afzonderlijke wijzigingenset, met zijn eigen toepasselijke opmerking voor wijzigingenset. Potlatch past standaard uw bewerkingen toe op een bestaande wijzigingenset, maar u kunt "C" typen om de huidige wijzigingenset te sluiten. JOSM maakt standaard een nieuwe wijzigingenset voor elke upload, maar u kunt die instelling wijzigen in het dialoogvenster voor uploaden.

Opnieuw gebruiken van oude opmerkingen

De meeste bewerkers zullen u toestaan om een oudere opmerking opnieuw te gebruiken door ze weer te geven in ene keuzelijst. Dat zou op dat moment handig kunnen lijken, maar trap niet in de "val van handig zijn" van het gebruiken van te algemene opmerkingen ("some fixes") zodat u ze opnieuw kunt gebruiken voor al uw bewerkingen. Dat maakt de opmerkingen waardeloos. Wees ook voorzichtig om geen opmerking toe te passen die niet overeenkomt met uw bewerkingen.

Zie ook