<div dir="ltr">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).<br><br><div>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.</div><div><br></div><div>Unfortunately, even having money to spend, it seems difficult to get people that are free to do it...</div><div><br></div><div>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.</div><div><br></div><div>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.</div><div><br></div><div>Best regards,</div><div><br></div><div>Alexandre Neto<br></div><div><br></div><br><div class="gmail_quote"><div dir="ltr">DelazJ <<a href="mailto:delazj@gmail.com">delazj@gmail.com</a>> escreveu no dia sexta, 13/04/2018 às 11:21:<br></div><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex"><div dir="ltr">Hi Yves,<br><div class="gmail_extra"><br><div class="gmail_quote"></div></div></div><div dir="ltr"><div class="gmail_extra"><div class="gmail_quote">2018-04-13 11:47 GMT+02:00 Yves Jacolin <span dir="ltr"><<a href="mailto:yjacolin@free.fr" target="_blank">yjacolin@free.fr</a>></span>:<br><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left:1px solid rgb(204,204,204);padding-left:1ex">Hello,<br>
<br>
I am more pessimistic. My opinion is just that documentation is not fun<br>
(at least not as feature development is), boring and not valuable from a<br>
skills point of view (I don't mean valuable on the project side).<br>
<br></blockquote></div></div></div><div dir="ltr"><div class="gmail_extra"><div class="gmail_quote"><div>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.<br><br>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.<br></div><div>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. <br><br></div></div></div></div><div dir="ltr"><div class="gmail_extra"><div class="gmail_quote"><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left:1px solid rgb(204,204,204);padding-left:1ex">
All in all, people could be tired to work on such a tasks in the long<br>
term. This is what I feel from Harrissou email and from my own experience.<br>
<br></blockquote></div></div></div><div dir="ltr"><div class="gmail_extra"><div class="gmail_quote"><div>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.<br><br></div><div>H.<br><br></div></div></div></div><div dir="ltr"><div class="gmail_extra"><div class="gmail_quote"><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left:1px solid rgb(204,204,204);padding-left:1ex">
Unfortunately, I didn't have time the previous year and can't go to the<br>
haskfest which doesn't help to contribute.<br>
<br>
Sorry for a so pessimistic email.<br>
<br>
Y.<br>
<div class="m_9210377256827219636gmail-HOEnZb"><div class="m_9210377256827219636gmail-h5"><br>
<br>
Le 13/04/2018 à 11:39, matteo a écrit :<br>
> Hi Harrissou,<br>
><br>
> thanks for raising this. I would say we really need more people working<br>
> on the documentation. I don't know how to find other contributors but we<br>
> have.<br>
><br>
> Just run<br>
><br>
> git shortlog -sn --after="2018-01-01"<br>
><br>
> and you can see that there are a few contributors for this repo.<br>
><br>
> IMHO now that images preview are visible in github there is easier also<br>
> for other people to contribute.<br>
><br>
> I cannot understand if there are some people out there that want to<br>
> contribute but the system "complexity" (git + sphinx + ...) blocks them<br>
> to do that.<br>
><br>
> Just thinking aloud: do you think that a short video tutorial could be<br>
> useful? We have a nice documentation for who wants to step in, but a<br>
> short and explicit video maybe is more sexy?<br>
><br>
><br>
> Thanks again for raising this<br>
><br>
> Cheers<br>
><br>
> Matteo<br>
> _______________________________________________<br>
> Qgis-community-team mailing list for organizing community resources such as documentation, translation etc..<br>
> <a href="mailto:Qgis-community-team@lists.osgeo.org" target="_blank">Qgis-community-team@lists.osgeo.org</a><br>
> <a href="https://lists.osgeo.org/mailman/listinfo/qgis-community-team" rel="noreferrer" target="_blank">https://lists.osgeo.org/mailman/listinfo/qgis-community-team</a><br>
<br>
</div></div><span class="m_9210377256827219636gmail-HOEnZb"><font color="#888888">-- <br>
<a href="http://yjacolin.gloobe.org" rel="noreferrer" target="_blank">http://yjacolin.gloobe.org</a><br>
<br>
<br>
</font></span><br>_______________________________________________<br>
Qgis-community-team mailing list for organizing community resources such as documentation, translation etc..<br>
<a href="mailto:Qgis-community-team@lists.osgeo.org" target="_blank">Qgis-community-team@lists.osgeo.org</a><br>
<a href="https://lists.osgeo.org/mailman/listinfo/qgis-community-team" rel="noreferrer" target="_blank">https://lists.osgeo.org/mailman/listinfo/qgis-community-team</a><br></blockquote></div></div></div>
_______________________________________________<br>
Qgis-community-team mailing list for organizing community resources such as documentation, translation etc..<br>
<a href="mailto:Qgis-community-team@lists.osgeo.org" target="_blank">Qgis-community-team@lists.osgeo.org</a><br>
<a href="https://lists.osgeo.org/mailman/listinfo/qgis-community-team" rel="noreferrer" target="_blank">https://lists.osgeo.org/mailman/listinfo/qgis-community-team</a></blockquote></div></div>-- <br><div dir="ltr" class="gmail_signature" data-smartmail="gmail_signature"><div dir="ltr"><div>Alexandre Neto</div><div>---------------------</div><div>@AlexNetoGeo</div><div><a href="http://sigsemgrilhetas.wordpress.com">http://sigsemgrilhetas.wordpress.com</a></div><a href="http://gisunchained.wordpress.com">http://gisunchained.wordpress.com</a><br></div></div>