<div dir="ltr"><div dir="ltr">Hi all,<br></div><br><div class="gmail_quote"><div dir="ltr" class="gmail_attr">Le ven. 18 oct. 2019 à 09:14, matteo <<a href="mailto:matteo.ghetta@gmail.com">matteo.ghetta@gmail.com</a>> a écrit :<br></div><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left:1px solid rgb(204,204,204);padding-left:1ex">Hi all,<br>
<br>
while reading the data and interpreting the results, what I found is<br>
that basically our official docs are not the firsts choice. People are<br>
mostly used to write something on google (or whatever) and get an<br>
answer. </blockquote><div><br></div><div>Why? Because it's easier to do a web search for an item than browsing a document. This is true for QGIS but applies to any other software. You do a web search and then pick among what are returned (first! because you assume they are the most relevant). And this is where we are failing. Responders point that: our docs are not returned efficiently. Basically, do a search for "QGIS expression": the first results are far from being the latest version; you got 2.18, 2.14, 2.8 docs depending on the web search you use (I tried duckduckgo, google, qwant). This is a known issue [0], an issue being "fixed" [1] (there's still a lot to do: we should ensure our latest docs is best served in web search engine - there are elements in the report I mentioned earlier for anyone willing to help there)</div><div>The other part of the issue is, for those who know that there's an official document, our search engine is failing or not as efficient as it should be. Also a known issue [2][3] <br></div><div><br></div><div>There are other reasons:</div><div>* docs not clearly explaining the feature: sometimes it's because we don't know (an almost empty PR - ref Nyall's comment on the changelog) and fail to have someone explain to us what the feature exactly does</div><div>* docs not always up to date</div><div>* docs not well written (yep! we are not all professional writers and we need to improve)<br></div><div>* ...</div><div></div><div>BUT if you first don't find the docs and then the feature, there's a little chance you use it. So ensuring our docs are useful is not only about writing features, it's first about visibility and fixing visibility issues rely on developers skills. Yes, the docs need devs skill to fix inherent issues. And sorry to say but I sometimes feel like there's a lack of cohesion between the "teams" in the community and I'm personally fed up with constantly **begging** help for these kinds of issues (see eg feedback [4] to take a recent call).<br></div><div> </div><div>[0] <a href="https://github.com/qgis/QGIS-Documentation/issues/3452" target="_blank">https://github.com/qgis/QGIS-Documentation/issues/3452</a><div>[1] <a href="https://github.com/qgis/QGIS-Documentation/pull/4274" target="_blank">https://github.com/qgis/QGIS-Documentation/pull/4274</a></div><div><div>[2] <a href="https://github.com/qgis/QGIS-Website/issues/156" target="_blank">https://github.com/qgis/QGIS-Website/issues/156</a></div><div>[3] <a href="https://github.com/qgis/QGIS-Documentation/issues/2059" target="_blank">https://github.com/qgis/QGIS-Documentation/issues/2059</a></div><div>[4] <a href="http://qgis-community-team.2324516.n4.nabble.com/Qgis-community-team-Documentation-wish-list-for-quot-hackfesters-quot-td3069.html">http://qgis-community-team.2324516.n4.nabble.com/Qgis-community-team-Documentation-wish-list-for-quot-hackfesters-quot-td3069.html</a></div><div><br></div><div>Regards,</div><div>Harrissou</div><div><br></div></div></div><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left:1px solid rgb(204,204,204);padding-left:1ex">Our (super beautiful docs) are more something to read slowly,<br>
study and make yours.<br>
<br>
The doc team did and is still doing an incredible work but we are<br>
relying on too few people.<br>
<br>
After discussing in these months with the doc team, psc, osgeo people,<br>
etc.. my conclusions are:<br>
<br>
* we have a complex framework with a steep learning curve for all the<br>
newcomers. Even if we wrote the guidelines, Alexandre made videos and<br>
people are helping other ones, we have spot PR of newcomers. BTW: I love<br>
our framework and wouldn't change it<br>
<br>
* even if we become more "soft" while reviewing PR (and with the "new"<br>
github system to directly accept reviewer's suggestions) I see new<br>
people scared by this system<br>
<br>
* the Postgres like manual is an idea, but we also should admit that<br>
postgres is a CLI software, QGIS has a lot of (beautiful) UIs<br>
<br>
Some times ago I tried to find a WYSIWYG system connected to git but<br>
couldn't find any suitable solution. I imagined something: the user logs<br>
it, adds/corrects/whatever something, before publishing the reviewers<br>
can approve it and we still have the history. IMHO such a system can<br>
attract more people CONTINUOUSLY to help us.<br>
<br>
Cheers and thanks for the discussion<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></blockquote></div></div>