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

Reply via email to