Tom, I agree with you that not having a documentation uptodate is a big
fail of the project. But I think it would not be that big if users were
aware of any strategy about documentation.
I think that:
- if we can release a doc concurrently with the application release (and
that's a huge target!)
- AND if users are aware that only LTR releases will be documented
- AND that there's a testing doc for non-LTR release
we would cover some gaps.

I'm not sure that the release cycle is a big problem. QGIS has gained
maturity and many features with this system. However I recall few years ago
discussion about integrating documentation as a part of any new features
from sponsors. Was that rejected? Is it followed?

Anyway, would be nice if a grant proposal could come on this side of the
project... _Harrissou dreaming..._

Harrissou

2017-03-06 14:01 GMT+01:00 Tom Chadwin <[email protected]>:

> A quick, sweeping, unhelpful but important opinion from me (non-dev,
> non-doc-writer).
>
> Please don't think that retrospective documentation, and lack of docs for
> current release (not master, but current non-LTR release) is good, just
> because that's how it is now. This is the *biggest* failing of the QGIS
> project when stacked up against commercial alternatives. Can you imagine a
> professional software package being released without full docs?
>
> I know that we just don't have the resources to improve this to where it
> should be, but perhaps this would be an argument to slow down the release
> cycle.
>
> To make it absolutely clear: that fact that current latest release of QGIS
> doesn't have docs is a huge failure.
>
> </tuppence>
>
>
>
> -----
> Buy Pie Spy: Adventures in British pastry 2010-11 on Amazon
> --
> View this message in context: http://osgeo-org.1560.x6.
> nabble.com/3-0-Documentation-and-branching-tp5306770p5310924.html
> Sent from the QGIS - Developer mailing list archive at Nabble.com.
> _______________________________________________
> Qgis-developer mailing list
> [email protected]
> List info: https://lists.osgeo.org/mailman/listinfo/qgis-developer
> Unsubscribe: https://lists.osgeo.org/mailman/listinfo/qgis-developer
>
_______________________________________________
Qgis-developer mailing list
[email protected]
List info: https://lists.osgeo.org/mailman/listinfo/qgis-developer
Unsubscribe: https://lists.osgeo.org/mailman/listinfo/qgis-developer

Reply via email to