[Qgis-psc] Draft call for documentation contributors

DelazJ delazj at gmail.com
Mon Dec 4 03:52:30 PST 2017


Hi Tim,
Thanks for this draft. Some first thoughts:
- When mentioning the "Sphinx based documentation", maybe could we add link
to documentation guidelines
- we could also mention that there some issue reports that are tagged
"easy" to lower the barrier for beginners (if needed). Btw, it could be
nice if some doc team members could review the list and check whether there
could be more "easy"-tagged issues (I tried but i don't know all the areas
of QGIS, hence can't always evaluate whether an issue is easy to fix or
not).
- I saw a call recently (from Alexandre?) arguing that writing doc is a
good way to learn new features. Maybe we could also use that argument to
show them other nice side of writing.

Sorry to just come with "suggestions" instead of "rewriting".

Regards,
Harrissou

2017-12-03 22:21 GMT+01:00 Tim Sutton <tim at kartoza.com>:

> Hi Yves and Harrisou
>
> I have drafted a blog article to try to get more documentation help in for
> the QGIS 3.0 release. Could you guys review it and let me know if there is
> anything else you would like to add / change (text below).
>
> Also just a reminder that there is budget for  supporting documentation -
> please use it if you can think of ways that money will productively improve
> and streamline the documentation process. Andreas can provide more details
> of available funs if needed. Draft text follows:
>
>
>
> ————
>
> Documentation for QGIS 3.0 - call for contributions!
>
> Dear QGIS users, enthusiasts and fine people out there. QGIS 3.0 is coming
> very soon....we are in a 'soft freeze' state at the moment while we wait
> for some critical last pieces of code to get finalised. Then we go into
> hard freeze and prepare to roll out our next major release. Those of you
> that have been playing with the '2.99' builds will surely have noticed that
> QGIS 3.0 is going to feature a huge number of improvements and new features
> - both in the user interface and in the API and code internals.
>
> But we have a *BIG* problem:
> we need your *help* to document and *describe* all those fine new
> *features!*
>
> Yes fine reader now is the time to break out of the 'passive user of QGIS'
> mould you might find yourself in and lend a hand. We have an issue tracker
> with an issue for each of the new features
> <https://github.com/qgis/QGIS-Documentation/issues?q=is%3Aopen+is%3Aissue+milestone%3A%22QGIS+3.0%22>
> that has landed in QGIS 3.0. Even if you do not know how to use our Sphinx
> based documentation system, you can help tremendously by preparing the
> prose that should be used to describe new features and attaching it to the
> issue list linked to above. If you do that, the documentation team can do
> more editorial work and less  'writing from scratch' work. If you want to
> see the QGIS Documentation
> <http://docs.qgis.org/2.18/en/docs/user_manual/> up-to-date for the
> version 3.0 release, please do get involved and help Yves Jacolin and the
> documentation team!
>
>
>
> ———————
>
> Regards
>
>
>
>
>
>
>
> ---
>
> *Tim Sutton*
> QGIS Project Steering Committee Chair
> tim at qgis.org
>
>
>
>
>
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.osgeo.org/pipermail/qgis-psc/attachments/20171204/523df29c/attachment.html>
-------------- next part --------------
A non-text attachment was scrubbed...
Name: qgis-icon-60x60.png
Type: image/png
Size: 4401 bytes
Desc: not available
URL: <http://lists.osgeo.org/pipermail/qgis-psc/attachments/20171204/523df29c/attachment.png>


More information about the Qgis-psc mailing list