[Qgis-user] [Qgis-developer] Stress about release plans

Alexander Bruy alexander.bruy at gmail.com
Tue Jul 22 03:05:23 PDT 2014


+ 1 to Otto and Victor.

Developers should develop, the can document some aspects of
code/feature (and they
already do this!) but we can not ask them to write manuals

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



-- 
Alexander Bruy



More information about the Qgis-user mailing list