[QGIS-Developer] [Qgis-community-team] Is releasing QGIS Documentation still in the plan?

[Alexandre Neto]

I think we need to put this conversation at least in the devs list, not
everybody is in this community list, so we probably end up talking to
ourselves (which may still happen, since Docs aren't sexy).

I don't think we will be able to do the documentation only with volunteers.
We will need to professionalize it. We need to pay people to write
documentation, and even to review it.

Unfortunately, even having money to spend, it seems difficult to get people
that are free to do it...

It's very frustrating to write lots of documentation, and then get stuck by
the lack of reviews. I know Harrissou is in that position. I would suggest
that, if after a period of time, the PR has no reviews at all, its owner is
free to merge it. I know it's not ideal but is better than having outdated
documentation while someones updates are in standby forever.

BTW, it's on my TODO list to update the documentation video, focusing on
the github approach. ut I don't know when I will have time for that.

Best regards,

Alexandre Neto


DelazJ <delazj at gmail.com> escreveu no dia sexta, 13/04/2018 às 11:21:

> Hi Yves,
>
> 2018-04-13 11:47 GMT+02:00 Yves Jacolin <yjacolin at free.fr>:
>
>> Hello,
>>
>> I am more pessimistic. My opinion is just that documentation is not fun
>> (at least not as feature development is), boring and not valuable from a
>> skills point of view (I don't mean valuable on the project side).
>>
>> I would like to disagree. Documentation may not be fun for devs, but QGIS
> community is not all about devs and we should stop using this argument;
> there are teachers, trainers, blogposters, users... people who are used to
> communicate about QGIS features and this is an area that should be of
> interest to them or should be within their reach.
>
> Also, maybe because I'm not a dev, working on docs made me learn some
> python, git and rst things that are not part of my daily work so yes, I
> developed some skills (and interest) I think.
> Now related to my daily work, writing the docs teaches me a lot of
> features and subtleties in using QGIS. And I'm not sure I'd have found them
> if not doing that. Sidenote: bug reporting comes also with that.
>
> All in all, people could be tired to work on such a tasks in the long
>> term. This is what I feel from Harrissou email and from my own experience.
>>
>> Actually, I'm not tired (or maybe I'm not conscious of that) but at the
> beginning, for the fun, I was wondering how many pull requests would be
> opened before any review begins and now I think that it's not worth
> spending (wasting?) time in some(community)thing if no one seems interested
> in it. There are many other things to do out there.
>
> H.
>
> Unfortunately, I didn't have time the previous year and can't go to the
>> haskfest which doesn't help to contribute.
>>
>> Sorry for a so pessimistic email.
>>
>> Y.
>>
>>
>> Le 13/04/2018 à 11:39, matteo a écrit :
>> > Hi Harrissou,
>> >
>> > thanks for raising this. I would say we really need more people working
>> > on the documentation. I don't know how to find other contributors but we
>> > have.
>> >
>> > Just run
>> >
>> > git shortlog -sn --after="2018-01-01"
>> >
>> > and you can see that there are a few contributors for this repo.
>> >
>> > IMHO now that images preview are visible in github there is easier also
>> > for other people to contribute.
>> >
>> > I cannot understand if there are some people out there that want to
>> > contribute but the system "complexity" (git + sphinx + ...) blocks them
>> > to do that.
>> >
>> > Just thinking aloud: do you think that a short video tutorial could be
>> > useful? We have a nice documentation for who wants to step in, but a
>> > short and explicit video maybe is more sexy?
>> >
>> >
>> > Thanks again for raising this
>> >
>> > Cheers
>> >
>> > Matteo
>> > _______________________________________________
>> > Qgis-community-team mailing list for organizing community resources
>> such as documentation, translation etc..
>> > Qgis-community-team at lists.osgeo.org
>> > https://lists.osgeo.org/mailman/listinfo/qgis-community-team
>>
>> --
>> http://yjacolin.gloobe.org
>>
>>
>>
>> _______________________________________________
>> Qgis-community-team mailing list for organizing community resources such
>> as documentation, translation etc..
>> Qgis-community-team at lists.osgeo.org
>> https://lists.osgeo.org/mailman/listinfo/qgis-community-team
>>
> _______________________________________________
> Qgis-community-team mailing list for organizing community resources such
> as documentation, translation etc..
> Qgis-community-team at lists.osgeo.org
> https://lists.osgeo.org/mailman/listinfo/qgis-community-team

-- 
Alexandre Neto
---------------------
@AlexNetoGeo
http://sigsemgrilhetas.wordpress.com
http://gisunchained.wordpress.com
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.osgeo.org/pipermail/qgis-developer/attachments/20180413/34da44ee/attachment-0001.html>