[josm-dev] Please invest some time into documentation - especially confilict resolution

[Dirk Stöcker]

On Sun, 4 Oct 2009, Rolf Bode-Meyer wrote:

>>> So please would those people who implemented conflict handling give
>>> detailed explanations in [[Help/Dialog/Conflict]] which currently is
>>> simply not helpful?
>>
>> You really need no programmer to write documentation.
>>
>> A good way to reach that goal would be to start writing that documentation
>> and ask the developers to fix or continue wrong or missing parts only.
>
> For JOSM I think most processes or dialogues are quite simple and
> comprehensible. So only a few people need documentation and nobody
> writes it.
> Especially for the conflict stuff I think it really is needed and I'd
> write that documentation - but I'm lost as many else seem to be here.
> So assuming the one who developed it knows best how it works, I think
> at least this time it's a job for a developer.

The problem is that these dialogs are Karl's design. He knows how they 
work best and that also means all is very plausible to him (for me too 
BTW). A very bad start when writing docs. Best is when someone who does 
NOT know how it was designed writes docs. The errors he makes and the 
questions he asks are very valuable input for fixing design issues and 
also the result will be much more a documentation for beginners.

So we again have a situation that many people have many opinions and all 
sides say "you need to do it". Karl and all developers already did a lot. 
I always think it's time for the others to show they also want to 
contribute before I believe words like "We continue after you start".

Ciao
-- 
http://www.dstoecker.eu/ (PGP key available)