[Qgis-community-team] Draft paper discussing QGIS docs

[Andreas Neumann]

Hi Cameron,

Thank you for summarizing your observations and assessment on the 
current state of documentation in QGIS.

I agree that the documentation task seems to be overwhelming and might 
also be daunting for newcomers, volunteers and even paid people. I also 
agree that the team is under-resourced.

However, we already knew this before your assessment.

So I wonder if you could add your thoughts and recommendations on how to 
improve our situation? We already know about our misery and bad state, 
but it would be encouraging to hear more suggestions for how to improve 
the situation. This would be really valuable for us.

It is not primarily a problem of finding financial resources. Every year 
we assigned funds for documentation and in most years those funds 
haven't been used. Even if we would make more funds available to the 
team, I feel this wouldn't solve the problems the team is facing.

Should the team focus on smaller chunks/goals in order to have better 
progress and a better success feeling?

Are the tools to complicated?

Is there not enough information provided by developers or organizations 
who fund a new features?

Thanks again for adding more suggestions and advice to your document - 
this would help us much more than just the assessment of the current state.

Andreas

Am 26.08.19 um 14:35 schrieb Cameron Shorter:
> For those involved in QGIS docs,
>
> After a bit of brainstorming with Matteo about what next for QGIS 
> docs, I offered to put some ideas down into an article to give him 
> something tangible to take to the QGIS Project Steering Committee next 
> week.
>
> I feel my thoughts have room to be developed a bit and I'd be keen to 
> hear feedback on them before I copy to my blog at the end of this week.
>
> https://docs.google.com/document/d/11N5d1aBgkdQ80I7RKBlt_jx9Uk1RGsvOTeq_TSFeljA/edit# 
>
>
> Comments are preferred to track changes (which become hard to manage). 
> If you comment, please log in first so I know who said what.
>