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

2009-10-04 Thread Rolf Bode-Meyer
Hi I'm thrilled developement goes on in good speed and central issues like conflict resolution have been already touched. Unfortunatelly end user documentation stays far behind. While simpler functions can be documented by experienced users, I fear the field of conflict resolution in JOSM is a

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

2009-10-04 Thread Karl Guggisberg
? Regards Karl -Ursprüngliche Nachricht- Von: josm-dev-boun...@openstreetmap.org [mailto:josm-dev-boun...@openstreetmap.org] Im Auftrag von Rolf Bode-Meyer Gesendet: Sonntag, 4. Oktober 2009 10:21 An: josm-dev@openstreetmap.org Betreff: [josm-dev] Please invest some time into documentation

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

2009-10-04 Thread Dirk Stöcker
On Sun, 4 Oct 2009, Rolf Bode-Meyer wrote: There was a post just yesterday where some people agree that they just push the buttons at random until the conflict is either resolved or the changes completely messed up. Users always request better documentation, but when there is a good

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

2009-10-04 Thread Ævar Arnfjörð Bjarmason
On Sun, Oct 4, 2009 at 9:18 AM, Dirk Stöcker openstreet...@dstoecker.de wrote: On Sun, 4 Oct 2009, Rolf Bode-Meyer wrote: There was a post just yesterday where some people agree that they just push the buttons at random until the conflict is either resolved or the changes completely messed

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

2009-10-04 Thread Dirk Stöcker
On Sun, 4 Oct 2009, Ævar Arnfjörð Bjarmason wrote: Perhaps it would help if there was a way in JOSM to link from each dialog / logical part of the UI to the associated documentation page. Then you could always click Help (for this dialog) to get at the documentation. Press F1 above a feature

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

2009-10-04 Thread Ulf Lamping
Dirk Stöcker schrieb: On Sun, 4 Oct 2009, Ævar Arnfjörð Bjarmason wrote: Perhaps it would help if there was a way in JOSM to link from each dialog / logical part of the UI to the associated documentation page. Then you could always click Help (for this dialog) to get at the documentation.

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

2009-10-04 Thread David Earl
On 04/10/2009 10:18, Dirk Stöcker wrote: Till now I was not able to convince one single person to really update JOSM online docs (with more than typos), so it seems doing that work is not worth the effort. I documented the whole of Audio mapping in detail for the JOSM help (and in passing

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

2009-10-04 Thread Dirk Stöcker
On Sun, 4 Oct 2009, Ulf Lamping wrote: JOSM translation shows that users are taking care if the hurdle for a first start isn't too high. Me feeling is that the help system The number of translators is so low, that I fear that does not qualify as real good example of user help. Also only about

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

2009-10-04 Thread Karl Guggisberg
). -- Karl -Ursprüngliche Nachricht- Von: josm-dev-boun...@openstreetmap.org [mailto:josm-dev-boun...@openstreetmap.org] Im Auftrag von Dirk Stöcker Gesendet: Sonntag, 4. Oktober 2009 16:59 An: josm-dev@openstreetmap.org Betreff: Re: [josm-dev] Please invest some time into documentation

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

2009-10-04 Thread Dirk Stöcker
On Sun, 4 Oct 2009, Karl Guggisberg wrote: No. All my experience shows that this is untrue. People either help or they don't help. This goes along with my experience but the interesting point is how to find those who want to help. What do you have to do to attract people who would like to

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

2009-10-04 Thread Apollinaris Schoell
Josm Docu isn't really important. most functions are self explaining. What we really need is to understand what Josm does with the data and how this working with the API and the whole OSM database. Conflict resolution or history functionality are such topics where good docu or tutorials can help.

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

2009-10-04 Thread David Earl
On 04/10/2009 18:39, Apollinaris Schoell wrote: Josm Docu isn't really important. most functions are self explaining. Absolute nonsense. Just look at the comments new people make - they are overwhelmed and confused by JOSM. It's only self explaining if either you already know what you're doing

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

2009-10-04 Thread 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

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

2009-10-04 Thread Dirk Stöcker
On Sun, 4 Oct 2009, David Earl wrote: Josm Docu isn't really important. most functions are self explaining. Absolute nonsense. Just look at the comments new people make - they are overwhelmed and confused by JOSM. It's only self explaining if either you already know what you're doing or if

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

2009-10-04 Thread Dirk Stöcker
On Sun, 4 Oct 2009, Apollinaris Schoell wrote: But as said before this is NOT a task for the developers. It's not even a Josm problem. My problem in the last months was that the development was too fast to even catch up with the idea how things work. With a couple of bugs impossible. The

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

2009-10-04 Thread Ulf Lamping
Dirk Stöcker schrieb: 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

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

2009-10-04 Thread Karl Guggisberg
Auftrag von Ulf Lamping Gesendet: Sonntag, 4. Oktober 2009 23:54 An: josm-dev@openstreetmap.org Betreff: Re: [josm-dev] Please invest some time into documentation - especially confilict resolution Dirk Stöcker schrieb: On Sun, 4 Oct 2009, Rolf Bode-Meyer wrote: So please would those people who