I think a Software should explain their general functionality itselfand josm does this.But of course you can't explain every functionality by itself because this function is mainly used by some experts. In these cases its much better to have a wiki-documentation then only source code.

Henning


Am 29.06.2013 01:43, schrieb Bryce Nesbitt:


On Fri, Jun 28, 2013 at 9:16 AM, colliar <[email protected] <mailto:[email protected]>> wrote:

    Hey

    I wonder how useful the JOSM wiki is ?
    * Is it used at all ?
    * Why do only a handful persons edit it though you can even edit
    anonymously ?
    Comments ?


I have no interest in, or use for, the JOSM wiki.
These days I expect software to be navigable through the interface.
With all the software we use, who has time to read manuals?

"How to" guides for complicated multistep tasks can be useful... but
older style documentation that simply describes what is already on screen seems quite outmoded.
For example from the JOSM wiki:
source:trunk/images/aligncircle.png <http://josm.openstreetmap.de/browser/trunk/images/aligncircle.png> Align Nodes in Circle <http://josm.openstreetmap.de/wiki/Help/Action/AlignInCircle> O Move the selected nodes into a circle source:trunk/images/alignline.png <http://josm.openstreetmap.de/browser/trunk/images/alignline.png> Align Nodes in Line <http://josm.openstreetmap.de/wiki/Help/Action/AlignInLine> L Move the selected nodes into a line

I expect to learn the function and shortcuts for menu items from the software itself.



------------------------------
Perhaps you could share hit count statistics on the 'useful' question. If others find it useful they will link from page to page searching for content.


_______________________________________________
talk mailing list
[email protected]
http://lists.openstreetmap.org/listinfo/talk

_______________________________________________
talk mailing list
[email protected]
http://lists.openstreetmap.org/listinfo/talk

Reply via email to