<div dir="ltr"><div dir="ltr"></div><br><div class="gmail_quote"><div dir="ltr" class="gmail_attr">On Wed, Dec 18, 2019 at 8:59 AM 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">OK, if it's a quick thing then please submit a proposal and we'll vote<br>
it ASAP.<br>
Thanks.<br></blockquote><div><br></div><div></div><div>I've done a quick research, the current cookbook situation appears to be:</div><div><br></div><div>- python code samples/snippets: 202</div><div>- python code samples/snippets currently tested: 53</div><div><br></div><div>So, I think that the plan would be to:</div><div>1. check all the cookbook text for 3.10 API changes and update it accordingly</div><div>2. put the 149 untested snippets under test<br></div><div><br></div><div>As far as point 1 is concerned the following files have the 'outofdate' directive:</div><div> <br>./source/docs/pyqgis_developer_cookbook/server.rst<br>./source/docs/pyqgis_developer_cookbook/settings.rst<br>./source/docs/pyqgis_developer_cookbook/network_analysis.rst<br>./source/docs/pyqgis_developer_cookbook/canvas.rst<br>./source/docs/pyqgis_developer_cookbook/authentication.rst<br>./source/docs/pyqgis_developer_cookbook/plugins/ide_debugging.rst<br>./source/docs/pyqgis_developer_cookbook/plugins/pluginlayer.rst<br>./source/docs/pyqgis_developer_cookbook/plugins/releasing.rst<br>./source/docs/pyqgis_developer_cookbook/raster.rst</div><div><br></div><div>this of course doesn't mean that all others are necessarily uptodate, <br></div><div>but we can assume that they require less work to be updated.</div><div><br></div><div>It's a bit difficult to estimate the exact amount of work required to achieve <br></div><div>both tasks, especially because some code samples will require quite a lot</div><div>of setup and data in order to run in the automatic tests.</div><div><br></div><div>However, I think the most efficient way to proceed is to work on both <br></div><div>tasks simultaneously: while checking the code samples it will be easier <br></div><div>to also apply corrections to the text.</div><div><br></div><div>So, what I would like to propose is to start with 5 days of work and see where we <br></div><div>can get with that, there are probably some APIs that haven't changed much <br></div><div>between releases (authentication is an example).<br></div><div><br></div><div>Btw, when looking at this, I've added this small improvement: <a href="https://github.com/qgis/QGIS-Documentation/pull/4651">https://github.com/qgis/QGIS-Documentation/pull/4651</a></div><div><br></div><div>Cheers</div><div><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">
<br>
Il 18/12/19 08:57, Alessandro Pasotti ha scritto:<br>
> <br>
> <br>
> On Wed, Dec 18, 2019 at 8:54 AM Paolo Cavallini <<a href="mailto:cavallini@faunalia.it" target="_blank">cavallini@faunalia.it</a><br>
> <mailto:<a href="mailto:cavallini@faunalia.it" target="_blank">cavallini@faunalia.it</a>>> wrote:<br>
> <br>
>     Hi Ale,<br>
>     would this be suitable for a grant project?<br>
> <br>
> <br>
> <br>
> You tell me :)<br>
> <br>
> I thought I would have time to do it now in the next few weeks, but if I<br>
> will still have time later in the year I will apply for a grant.<br>
> <br>
> Cheers<br>
> <br>
>     Cheers.<br>
> <br>
>     Il 18/12/19 08:50, Alessandro Pasotti ha scritto:<br>
>     > Hi,<br>
>     ><br>
>     > I'd like like to make a deep revision and update of the cookbook<br>
>     and put<br>
>     > code snippets under automated testing.<br>
>     ><br>
>     > Are there any funds left for such activity?<br>
>     ><br>
>     > --<br>
>     > Alessandro Pasotti<br>
>     > w3:   <a href="http://www.itopen.it" rel="noreferrer" target="_blank">www.itopen.it</a> <<a href="http://www.itopen.it" rel="noreferrer" target="_blank">http://www.itopen.it</a>> <<a href="http://www.itopen.it" rel="noreferrer" target="_blank">http://www.itopen.it</a>><br>
>     ><br>
>     > _______________________________________________<br>
>     > Qgis-psc mailing list<br>
>     > <a href="mailto:Qgis-psc@lists.osgeo.org" target="_blank">Qgis-psc@lists.osgeo.org</a> <mailto:<a href="mailto:Qgis-psc@lists.osgeo.org" target="_blank">Qgis-psc@lists.osgeo.org</a>><br>
>     > <a href="https://lists.osgeo.org/mailman/listinfo/qgis-psc" rel="noreferrer" target="_blank">https://lists.osgeo.org/mailman/listinfo/qgis-psc</a><br>
>     ><br>
> <br>
>     -- <br>
>     Paolo Cavallini - <a href="http://www.faunalia.eu" rel="noreferrer" target="_blank">www.faunalia.eu</a> <<a href="http://www.faunalia.eu" rel="noreferrer" target="_blank">http://www.faunalia.eu</a>><br>
>     <a href="http://QGIS.ORG" rel="noreferrer" target="_blank">QGIS.ORG</a> <<a href="http://QGIS.ORG" rel="noreferrer" target="_blank">http://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-psc mailing list<br>
>     <a href="mailto:Qgis-psc@lists.osgeo.org" target="_blank">Qgis-psc@lists.osgeo.org</a> <mailto:<a href="mailto:Qgis-psc@lists.osgeo.org" target="_blank">Qgis-psc@lists.osgeo.org</a>><br>
>     <a href="https://lists.osgeo.org/mailman/listinfo/qgis-psc" rel="noreferrer" target="_blank">https://lists.osgeo.org/mailman/listinfo/qgis-psc</a><br>
> <br>
> <br>
> <br>
> -- <br>
> Alessandro Pasotti<br>
> w3:   <a href="http://www.itopen.it" rel="noreferrer" target="_blank">www.itopen.it</a> <<a href="http://www.itopen.it" rel="noreferrer" target="_blank">http://www.itopen.it</a>><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>
</blockquote></div><br clear="all"><br>-- <br><div dir="ltr">Alessandro Pasotti<br>w3:   <a href="http://www.itopen.it" target="_blank">www.itopen.it</a></div></div>