The problem with a wiki is that everyone can undo what you did. I remember trying to update the documentation for Potlatch once. Richard F. did not agree and undid my work the same day, because he as an author did not agree with my approach on help. True, it emphasized some aspects that were not the strong points of Potlatch, but it was meant to prevent users make silly mistakes.
I lost my respect and appetite for Richard that same day. I appreciate the work of Dirk, but also witnessed his temper, and I do not even want to try to tempt him in something alike. Dirk, on this subject we both do what we do best. You program and I'll shut up. Gert -----Oorspronkelijk bericht----- Van: Dirk Stöcker [mailto:openstreet...@dstoecker.de] Verzonden: vrijdag 12 augustus 2011 16:55 Aan: josm-dev@openstreetmap.org Onderwerp: Re: [josm-dev] JOSM donations? On Fri, 12 Aug 2011, ce-test, qualified testing bv - Gert Gremmen wrote: > The only solution is slowing the pace of updates, and > creating a team of volunteers that updates and approves > the documentation ahead of a new release. This will never come. We are no commercial software. This is OpenSource. If there is a documention team, then we do everything to support them. But we don't adapt software development to this. We don't delay release for translators to finish, we wont delay for documentation. > I imagine a contextual help function per item (it's more or less what we have > now in the wiki) > starting with a summary of what changed recently, and how it was done before. As said. It's a wiki. At every page can be added any relevant text. This also can be the information you suggest. It only must be added. There is no need to change anything for this. Simple to start: Go to http://josm.openstreetmap.de/wiki/Translations#Statustable and pick one of the yellow fields in one of the languages you know and update it. Or add one of the grey ones. Or go to http://josm.openstreetmap.de/wiki/DevelopersGuide/HelpSystem/HelpTopicsList and choose a missing one. If you find outdated information either fix it or add a "outdated=" note at the translation macro. The only one I know caring for the base English help ATM is skyper. And "da", "ja" and "uk" language translations are very active lately. But in the long time I'm software developer I heard many people complaining about missing documentation, but nobody of these every wrote a single paragraph to solve this situation. Ciao -- http://www.dstoecker.eu/ (PGP key available) _______________________________________________ josm-dev mailing list josm-dev@openstreetmap.org http://lists.openstreetmap.org/listinfo/josm-dev _______________________________________________ josm-dev mailing list josm-dev@openstreetmap.org http://lists.openstreetmap.org/listinfo/josm-dev