<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
</head>
<body bgcolor="#FFFFFF" text="#000000">
<p>Hi again,</p>
<p>Another observation I have is that there is an awful lot of
documentation about QGIS out their on the web, spread into many
personal blog websites, company blog posts and news sites, youtube
movies, social media posts, etc. etc. However, all of this vast
and de-centralized information doesn't end up in our central
documentation.<br>
</p>
<p>My assumption is that people prefer to add such information more
to their own, personal website, rather than to QGIS.OR because it
helps them to:</p>
<ul>
<li>build personal reputation (individual persons). I think about
people like Anita Graser, Klas Karlsson, and probably many
others who always add the new cool stuff to their own websites,
but not to QGIS.ORG<br>
</li>
<li>show off what cool features the company added recently to QGIS
core (which helps their business) - examples are companies like
OpenGIS, Oslandia, etc. who add new cool stuff to their company
website, but not to QGIS.ORG<br>
</li>
<li>better learn and understand how QGIS works (which is useful
for building up their skills). I heard from Harrissou that this
was his main motivation to contribute to the centralized QGIS
documentation.<br>
</li>
</ul>
<p>From these above three different motivations, only the last one
can be fulfilled by adding new information to our centralized
documentation, the other two are better done outside of the
centralized documentation.</p>
<p>So I wonder if the huge work of documentors in the centralized
documentation could be better credited/attributed to individuals,
so that the other two motivations of gaining personal or company
reputation by contributing to the centralized QGIS documentation
is better fulfilled?</p>
<p>Just some thoughts ...</p>
<p>Andreas<br>
</p>
<div class="moz-cite-prefix">Am 26.08.19 um 15:10 schrieb Andreas
Neumann:<br>
</div>
<blockquote type="cite"
cite="mid:585a32bd-f42c-5819-ae4a-e9e76b15ad95@carto.net">Hi
Cameron,
<br>
<br>
Thank you for summarizing your observations and assessment on the
current state of documentation in QGIS.
<br>
<br>
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.
<br>
<br>
However, we already knew this before your assessment.
<br>
<br>
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.
<br>
<br>
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.
<br>
<br>
Should the team focus on smaller chunks/goals in order to have
better progress and a better success feeling?
<br>
<br>
Are the tools to complicated?
<br>
<br>
Is there not enough information provided by developers or
organizations who fund a new features?
<br>
<br>
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.
<br>
<br>
Andreas
<br>
<br>
Am 26.08.19 um 14:35 schrieb Cameron Shorter:
<br>
<blockquote type="cite">For those involved in QGIS docs,
<br>
<br>
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.
<br>
<br>
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.
<br>
<br>
<a class="moz-txt-link-freetext" href="https://docs.google.com/document/d/11N5d1aBgkdQ80I7RKBlt_jx9Uk1RGsvOTeq_TSFeljA/edit#">https://docs.google.com/document/d/11N5d1aBgkdQ80I7RKBlt_jx9Uk1RGsvOTeq_TSFeljA/edit#</a>
<br>
<br>
Comments are preferred to track changes (which become hard to
manage). If you comment, please log in first so I know who said
what.
<br>
<br>
</blockquote>
_______________________________________________
<br>
Qgis-community-team mailing list for organizing community
resources such as documentation, translation etc..
<br>
<a class="moz-txt-link-abbreviated" href="mailto:Qgis-community-team@lists.osgeo.org">Qgis-community-team@lists.osgeo.org</a>
<br>
<a class="moz-txt-link-freetext" href="https://lists.osgeo.org/mailman/listinfo/qgis-community-team">https://lists.osgeo.org/mailman/listinfo/qgis-community-team</a><br>
</blockquote>
</body>
</html>