<div dir="ltr"><br><br><div class="gmail_quote"><div dir="ltr" class="gmail_attr">---------- Forwarded message ---------<br>From: <strong class="gmail_sendername" dir="auto">Alexandre Neto</strong> <span dir="auto"><<a href="mailto:senhor.neto@gmail.com">senhor.neto@gmail.com</a>></span><br>Date: Wed, Dec 18, 2019 at 11:30 AM<br>Subject: Re: [Qgis-community-team] [Qgis-psc] QGIS Documentation strategic meeting<br>To: Paolo Cavallini <<a href="mailto:cavallini@faunalia.it">cavallini@faunalia.it</a>><br>Cc: qgis-community <<a href="mailto:qgis-community-team@lists.osgeo.org">qgis-community-team@lists.osgeo.org</a>><br></div><br><br><div dir="ltr">Sorry for the delay. Here are some key thoughts we agreed at the end of the meeting.<br><br>- Focus the documentation work on the User Manual and the PyCookbook<div>- Make providing documentation for new features mandatory at the Pull Request review. If the coder does not provide some kind of documentation explaining the new features, it can not be merged. (Blog post somewhere else are acceptable, but PRs to Documentation repo would be even better ofc)<br><div>- Split the several docs in different repositories to make it easier to build, allow different timings for their releases, and separate the continuous integration. Move static content, not dependent from the QGIS version to the website.</div><div>- Update the Sphinx theme to read the docs theme, this will help to build the docs in windows and Linux, and allow us to update our structure more often (our is quite outdated)</div><div>- Update the PyCookBook to QGIS 3.10 and activate testing on "all" snippets (maybe as a grant proposal)<br></div><div>- Have Continuous integration between QGIS master and the PyCookbook to allow warnings when the cookbook stops to work</div><div></div><div>- In a next hackfest, make Documentation the hacking focus, to allow everybody to participate and understand how hard it is to keep up with the new features</div><div>- Make some online | remove events to get people together to work on the documentation</div><div>- Remove some verbose on the Sphinx syntax to make it easier to catch by newcomers (e.g. replace guilables by simple bold)<br><br>If I missed something, please correct me.</div><div><br></div><div>Thanks!<br><br>Alexandre Neto</div></div></div><br><div class="gmail_quote"><div dir="ltr" class="gmail_attr">On Tue, Dec 17, 2019 at 2:25 PM Paolo Cavallini <<a href="mailto:cavallini@faunalia.it" target="_blank">cavallini@faunalia.it</a>> wrote:<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 Larissa,<br>
no decision has been taken yet, all options are open.<br>
Cheers.<br>
<br>
Il 17/12/19 15:13, Larissa Junek ha scritto:<br>
> Hello all,<br>
> as far as I could follow the discussion: will the training manual not be<br>
> supported anymore because of the direction to have a core documentation?<br>
<br>
-- <br>
Paolo Cavallini - <a href="http://www.faunalia.eu" rel="noreferrer" target="_blank">www.faunalia.eu</a><br>
<a href="http://QGIS.ORG" rel="noreferrer" target="_blank">QGIS.ORG</a> Chair:<br>
<a href="http://planet.qgis.org/planet/user/28/tag/qgis%20board/" rel="noreferrer" target="_blank">http://planet.qgis.org/planet/user/28/tag/qgis%20board/</a><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></div>