FR:Bons commentaires de groupe de modifications

From OpenStreetMap Wiki
(Redirected from FR:Good changeset comments)
Jump to: navigation, search
Langues disponibles — Good changeset comments
· Afrikaans · Alemannisch · aragonés · asturianu · azərbaycanca · Bahasa Indonesia · Bahasa Melayu · Bân-lâm-gú · Basa Jawa · Baso Minangkabau · bosanski · brezhoneg · català · čeština · dansk · Deutsch · eesti · English · español · Esperanto · estremeñu · euskara · français · Frysk · Gaeilge · Gàidhlig · galego · Hausa · hrvatski · Igbo · interlingua · Interlingue · isiXhosa · isiZulu · íslenska · italiano · Kiswahili · Kreyòl ayisyen · kréyòl gwadloupéyen · Kurdî · latviešu · Lëtzebuergesch · lietuvių · magyar · Malagasy · Malti · Nederlands · Nedersaksies · norsk bokmål · norsk nynorsk · occitan · Oromoo · oʻzbekcha/ўзбекча · Plattdüütsch · polski · português · português do Brasil · română · shqip · slovenčina · slovenščina · Soomaaliga · suomi · svenska · Tiếng Việt · Türkçe · Vahcuengh · vèneto · Wolof · Yorùbá · Zazaki · српски / srpski · беларуская · български · қазақша · македонски · монгол · русский · тоҷикӣ · українська · Ελληνικά · Հայերեն · ქართული · नेपाली · मराठी · हिन्दी · অসমীয়া · বাংলা · ਪੰਜਾਬੀ · ગુજરાતી · ଓଡ଼ିଆ · தமிழ் · తెలుగు · ಕನ್ನಡ · മലയാളം · සිංහල · ไทย · မြန်မာဘာသာ · ລາວ · ភាសាខ្មែរ · ⵜⴰⵎⴰⵣⵉⵖⵜ · አማርኛ · 한국어 · 日本語 · 中文(简体)‎ · 吴语 · 粵語 · 中文(繁體)‎ · ייִדיש · עברית · اردو · العربية · پښتو · سنڌي · فارسی · ދިވެހިބަސް
NDT : le mot anglais changeset est souvent non traduit lors de discussions car il s’agit d'un mot souvent utilisé dans le « jargon » du contributeur OpenStreetMap. Certains éditeurs le traduisent cependant comme « groupe de modifications ».

Qu'est ce qu'un commentaire de changeset

Un Changeset est un groupe de modifications réalisées par un seul contributeur dans un temps assez court.

Quand vous postez un changeset, l'éditeur que vous utilisez vous donne l'opportunité d'ajouter une description de votre groupe de modifications - les vues suivantes sont respectivement celles de iD, decPotlach et de JOSM :

Le commentaire que vous saisissez ici sera celui publié avec vos éditions dans de nombreuses situations, comme par exemple si quelqu'un regarde l'historique d'un objet ou surveille tous les changements affectant une zone.

Pourquoi devrais-je utiliser les commentaires de Changeset ?

Il y a plusieurs raisons qui devraient vous faire utiliser les commentaires sur vos changesets pour décrire vos éditions :

  • Par courtoisies envers vos collègues cartographes, car il rend plus facile la compréhension de ce que vous avez fait et pourquoi. Ne pas utiliser le commentaire de changeset a l'air de vouloir dire "Ce n'est pas votre affaire ce que j'ai fait ici et pourquoi" et ne correspond pas à la l'esprit d'un projet dans lequel nous travaillons tous à faire la même chose !
  • Pour éviter les malentendus et réparer les erreurs rapidement - Si une édition avec comme commentaire de changeset : "Tracé d'un couple de maison à l'aide de Bing" a supprimé 50 restaurants, alors il est clair qu'il y a sûrement eu une erreur, alors que le commentaire de changeset "suppression de restaurants que j'ai vu fermés lors de repérages sur le terrain la semaine dernière" rendra clair le fait que vous avez réellement supprimé ces restaurants pour de bonnes raisons.
  • Pour améliorer la valeur de vos éditions et prévenir les guerres d'éditions en expliquant pourquoi vous avez fait telles éditions et en notant vos sources pour ces éditions. Si quelqu'un pense que vous avez ajouté une maison qui n'est pas visible sur ses images aériennes, il sera tenté de la supprimer, mais si vous avez commenté votre changeset de la sorte "ajouté une maison nouvellement construite", alors il y pensera à deux fois avant de la supprimer !

Certains contributeurs utilisent aussi le commentaire de changeset pour enregistrer quelque chose qu'il n'ont pas, ou pas encore fait ("... mais cela mérite encore plus de travail", "... mais la partie ouest de la rivière manque encore").

Il y a des situations où il est évident de voir le but d'un changeset - spécialement lorsque ce changeset n'affecte qu'un seul objet - mais ces situations sont bien moins communes que vous pensez. Si vous corrigez une typographie, un commentaire "correction typo" indiquera toujours plus clairement que c'est en effet ce que vous avez eu l'intention de faire, plutôt que votre chat qui a encore joué avec votre clavier !

Exemples

Un bon commentaire de changeset devrait décrire de manière adéquate et concise une édition.

Bons commentaires

Voici de réels bons exemples de changeset :

  • "Mise à jour d'adresses sur la Danish street addresses depuis OSAK (AWS): Bag Hegnet"
  • "Attention, les bâtiments supprimés ont été rasés fin 2010, ne les ajoutez pas a nouveau svp"
  • "Ajouté une jonction pour les piétons de Donnington à la voie romaine selon des connaissances locales"
  • "Mise à jour des frontières du park Algonquin"
  • "Ajouté des routes de campagnes et pistes cyclables au SE de Newport"
  • "Cologne: supprimé junction=roundabout sur carrefours qui n'en sont pas, pas de panneau de signalisation n°215"
  • "Ajouté quelques bras de mer à la ligne de cote de Maranhão"
  • "Ajouté des bâtiments dans une zone industrielle"
  • "Itinéraire cycliste Stora Vargleden. Routes et chemins dans Tiveden."
  • "Ajouté des détails dans Upper Ferntree Gully - Montrose Victoria, Australia depuis Bing et surveillance à la suite du bot de redaction"
  • "Mis à jour les routes autour du Wolf Lake Bemiji MN basé sur des photos satellite"
  • "Ajouté la zone naturelle Hawthorn Pond (Holland Twp. MI), ces chemins et aménités"
  • "Corrigé le quai du port de LSO"
  • "Ajouté des maisons et des numéros de maisons selon Bing et connaissance locale. Quelques numéros de maison n'ont malheureusement pu être trouvé"

Mauvais commenaires

Certains commentaires de changeset sont inutiles et n'apportent aucun de bénéfices qu'un commentaire peut apporter, voici ainsi quelques exemples de mauvais commentaires de changeset :

  • "BBOX:3.23,41.96,3.23,41.96 ADD:14 UPD:0 DEL:0"
  • "Envoi d'éditions par ArcGIS Editor for OpenStreetMap feature service dec20 at 1/13/2012 9:56:00 AM"
  • "Quelques corrections"
  • "Ajouts à la carte"
  • "--"

Commentaires inutiles et/ou toxiques

Mais il y a des commentaires qui sont encore pire qu'inutiles - quelques exemples de très mauvais commentaires de changeset:

  • "Que l'idiot qui a codé ce truc apprenne à donner des messages d'erreur utiles, svp"
  • "F*** Potlach2, fatigué de réparer les séquelles de ce bug"
  • "F*** Merkaartor SVN."
  • "dfshksdhkhksdfhkasf (stupide exigence de JOSM)"
  • "Ou j'étais, et pourquoi et quand, ce n'est l'affaire de personne"

Rappelez-vous s'il vous plaît que vos commentaires de changeset vont rester dans la base de donnée aussi longtemps que le projet existera; ne les utilisez pas pour exprimer de la colère contre les logiciels ou vos collègues contributeurs qui vous ont peut être demandé de corriger quelque chose, ou mis en question vos sources.

Prudence lors d'ajout à un changeset

Quand vous envoyez un changeset et spécifiez un commentaire, l'éditeur ne ferme pas toujours le changeset, les éditions ultérieures peuvent être ajoutées au même changeset et ainsi partager le même commentaire de changeset.

Si vous avez fini un travail d'édition et commencez à éditer autre chose, faites attention à bien enregistrer cette nouvelle édition dans un changeset séparé, avec son commentaire approprié. Potlach ajoute toutes vos éditions à un changeset existant par défaut, mais vous pouvez fermer le changeset en cours en appuyant sur la touche "C". JOSM crée un nouveau changeset pour chaque envoi par défaut, mais vous pouvez changer ce réglage dans la boite de dialogue d'envoi (cf image suivante)

Parametres envoi josm.png

Réutilisation d'anciens commentaires

La plupart des éditeurs permettent de réutiliser un ancien commentaire dans une liste déroulante. Cela a parfois du sens, mais ne tombez pas dans le piège de la facilité en utilisant des commentaires trop génériques ("quelques corrections") juste pour pouvoir les réutiliser pour toutes vos éditions. Cela rend les commentaires inutiles. Prenez soin aussi de ne pas utiliser un ancien commentaire qui ne correspond pas à vos éditions.

Voir aussi