<div dir="ltr">Hi,<br><div class="gmail_extra"><br><div class="gmail_quote">2018-04-13 14:29 GMT+02:00 matteo <span dir="ltr"><<a href="mailto:matteo.ghetta@gmail.com" target="_blank">matteo.ghetta@gmail.com</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">Hi,<br>
<span class="gmail-m_4698777630656801821gmail-"><br>
> I think we need to put this conversation at least in the devs list, not<br>
> everybody is in this community list, so we probably end up talking to<br>
> ourselves (which may still happen, since Docs aren't sexy).<br>
<br>
</span>+1 (even if we maybe will keep up the discussion by ourselves ;) )<br>
<span class="gmail-m_4698777630656801821gmail-"><br></span></blockquote><div>Sadly true!<br> <br></div><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left:1px solid rgb(204,204,204);padding-left:1ex"><span class="gmail-m_4698777630656801821gmail-">
> I don't think we will be able to do the documentation only with volunteers.<br>
> We will need to professionalize it. We need to pay people to write<br>
> documentation, and even to review it.<br>
> <br>
> Unfortunately, even having money to spend, it seems difficult to get people<br>
> that are free to do it...<br>
> <br></span></blockquote><div>ditto ;(<br></div><div>Though review is often less time consuming than writing...<br></div><div> <br></div><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left:1px solid rgb(204,204,204);padding-left:1ex"><span class="gmail-m_4698777630656801821gmail-">
> It's very frustrating to write lots of documentation, and then get stuck by<br>
> the lack of reviews. I know Harrissou is in that position. I would suggest<br>
> that, if after a period of time, the PR has no reviews at all, its owner is<br>
> free to merge it. I know it's not ideal but is better than having outdated<br>
> documentation while someones updates are in standby forever.<br>
<br>
</span>I'm + 1 also on this. I think that the errors that a merged PR could<br>
introduce are still better to have a long cue of unmerged PR. Knowing<br>
that it is always better to have reviewed docs, but maybe (just maybe)<br>
errors are easier to find during the final reading of the docs..<br>
<span class="gmail-m_4698777630656801821gmail-"><br></span></blockquote><div>Thanks to those who reviewed some of the existing pull-requests.<br>My concern with "no review - just merge" rule is that issue in docs are hard to find later. We have no tools to check for typos, for wrong formulation (sorry but English is not the mother tongue of most of us), wrong description of tool behavior (That's what personally worries me the most, I often try tools before documenting but unfortunately things are not always obvious and reviews help to reduce mistakes). And doing that alone is just boring! Also, the consequences are 1/mislead users and 2/overload translators work (a first time in translating the wrong text - in case it's clear enough to try a translation - and a second time when the issue is found and fixed in the English part). <br></div><div>Using that "no review - just merge" rule should be an exception and not a rule by default.<br></div><div><br></div><div>That said, I finally merged a dozen of unreviewed/"not discussed" PRs that had more than 2 weeks, as I feel they'd not get much attention, and closed around 20 issue reports. The nice news was that we've dropped to less than 400 issues to document... until few hours ago.<br></div><div>A nice goal would be to keep that number as a maximum threshold for the issue queue. There are already a lot of new (and shorter) PRs that would help to reach that goal so please, continue to review.<br>Unless doc release is stopped (which does not seem to be the *expressed* trend), I'll try to keep the goal achieved (and if possible, lower that limit) until... 3.4 doc release.<br></div><div>After that, without new docs initiative/contributor, it could be a nice opportunity to learn c++ ;)<br></div><div><br></div><div>There was that QGIS survey launched in 2015 [0] and if I'm not wrong, Anita published later an analysis of the teachings.  I can't find it. Can someone point me to that results, please?<br></div><div>I'd be really interested in another round. While I'm more interested in how the documentation perception may have (or not) changed these last years (if/who/why  knows/uses/does not contribute/needs/misses?) and docs future, it can also be the opportunity to take the community's pulse more formally and see if the project has improved or not (regarding their remarks three years ago). <br>Maybe, this can be done between 3.2 and 3.4 releases (3.x would not be that new "brand" and no LTR yet)? We would then also have time to prepare and translate such survey...<br><br>[0] <a href="http://blog.qgis.org/2015/10/15/take-the-qgis-user-survey/">http://blog.qgis.org/2015/10/15/take-the-qgis-user-survey/</a> (not available but...)<br><br></div><div>Regards,<br></div><div>Harrissou<br></div><div><br></div><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left:1px solid rgb(204,204,204);padding-left:1ex"><span class="gmail-m_4698777630656801821gmail-">
> BTW, it's on my TODO list to update the documentation video, focusing on<br>
> the github approach. ut I don't know when I will have time for that.<br>
<br>
</span>just ping if you need help<br>
<br>
Thanks<br>
<div class="gmail-m_4698777630656801821gmail-HOEnZb"><div class="gmail-m_4698777630656801821gmail-h5"><br>
Matteo<br>
______________________________<wbr>_________________<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.osge<wbr>o.org</a><br>
<a href="https://lists.osgeo.org/mailman/listinfo/qgis-community-team" rel="noreferrer" target="_blank">https://lists.osgeo.org/mailma<wbr>n/listinfo/qgis-community-team</a></div></div></blockquote></div><br></div></div>