<div dir="ltr"><div class="gmail_extra"><div>Except that self-evidently the current solution doesn't work well. Of the three projects I listed, QGIS has by far the worst documentation; as Otto noted, they've not even started updating for 2.4 yet.</div>

<div><br></div><div>Just looking now, not a single one of the "QGIS Geoalgorithms" that I've ever looked at (which are I think is what Victor is referencing) have anything in the "help" tab. And these are a core part of the software.</div>

<div><br></div><div>I appreciate developers hate writing documentation, and in fact they're often very bad at it anyway, but if other projects can do it with far fewer resources then I think QGIS should be able to manage it to, especially the commercial organisations that charge for feature development.</div>

<div><br></div><div>Cheers,</div><div>Jonathan<br><br></div><div><br></div>
<br><br><div class="gmail_quote">On 22 July 2014 11:05, Alexander Bruy <span dir="ltr"><<a href="mailto:alexander.bruy@gmail.com" target="_blank">alexander.bruy@gmail.com</a>></span> wrote:<br><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">

+ 1 to Otto and Victor.<br>
<br>
Developers should develop, the can document some aspects of<br>
code/feature (and they<br>
already do this!) but we can not ask them to write manuals<br>
<br>
2014-07-22 13:01 GMT+03:00 Victor Olaya <<a href="mailto:volayaf@gmail.com">volayaf@gmail.com</a>>:<br>
<div class="HOEnZb"><div class="h5">> +1 to what Otto said. Very good point. Those creating training materials<br>
> should coordinate and help the core QGIS documentation (both the manual and<br>
> the training manual) improve.<br>
><br>
>><br>
>> The solution is very simple: Require up to date, accurate documentation<br>
>> for all commits of new features. This is one for the PSC.<br>
>> After all, what's the point in having tons of features if no-one knows how<br>
>> to use them or what they do?<br>
>> Will it slow down new feature feature commit? Probably, but I figure<br>
>> that's a small price to pay for actually having documentation. And from that<br>
>> documentation, universal training materials can be developed much more<br>
>> easily.<br>
><br>
><br>
> -1 from me. Features are also  documented by people using them, not just by<br>
> the devs. We like to say that you can contribute to open source projects not<br>
> just by coding, but if we do that, I don't think we are going to get many<br>
> contributions from users, leaving the documentation to be written only by<br>
> developers.<br>
><br>
> I try to keep the Processing documentation up to date, but only documenting<br>
> the interface itself and the framework, not the algorithms. That's the<br>
> reason why a large part of algorithms in Processing are not documented.<br>
> Fortunately, some users have contributed documentation, and they have added<br>
> descriptions of several algorithms, but the have done that *after* using the<br>
> (hitherto undocumented) algorithm and becoming familiar with it. No one is<br>
> going to document something that he cannot use yet.<br>
><br>
> Let's encourage developers to commit features when they are well documented,<br>
> but let's also give some flexibility, since that's not always going to be<br>
> possible.<br>
><br>
> my 2 cents<br>
><br>
> Cheers<br>
> Víctor<br>
><br>
</div></div><div class="HOEnZb"><div class="h5">> _______________________________________________<br>
> Qgis-developer mailing list<br>
> <a href="mailto:Qgis-developer@lists.osgeo.org">Qgis-developer@lists.osgeo.org</a><br>
> <a href="http://lists.osgeo.org/mailman/listinfo/qgis-developer" target="_blank">http://lists.osgeo.org/mailman/listinfo/qgis-developer</a><br>
<br>
<br>
<br>
</div></div><span class="HOEnZb"><font color="#888888">--<br>
Alexander Bruy<br>
</font></span></blockquote></div><br></div></div>

<br>
<span style="color:rgb(34,34,34);font-family:Arial;background-color:rgb(255,255,255)">This transmission is intended for the named addressee(s) only and may contain confidential, sensitive or personal information and should be handled accordingly. Unless you are the named addressee (or authorised to receive it for the addressee) you may not copy or use it, or disclose it to anyone else. If you have received this transmission in error please notify the sender immediately. All email traffic sent to or from us, including without limitation all GCSX traffic, may be subject to recording and/or monitoring in accordance with relevant legislation.</span>