<html>
  <head>
    <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
  </head>
  <body>
    <p>Hi Alessandro, thanks a lot for the analysis, as I already
      mentioned in the docs meeting I think the py cookbook is very
      important and needs lots of love.</p>
    <p>I like your suggestion and I'd be in favour of doing it.</p>
    <p>cheers</p>
    <p>Marco<br>
    </p>
    <div class="moz-cite-prefix">On 19.12.19 15:37, Alessandro Pasotti
      wrote:<br>
    </div>
    <blockquote type="cite"
cite="mid:CAL5Q670TZXx3RqkBQSrjaapNmWwgxcwA9f6N5X_-KmmU4+uDVw@mail.gmail.com">
      <meta http-equiv="content-type" content="text/html; charset=UTF-8">
      <div dir="ltr"><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"
              moz-do-not-send="true">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>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"
              moz-do-not-send="true">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"
              moz-do-not-send="true">cavallini@faunalia.it</a><br>
            > <mailto:<a href="mailto:cavallini@faunalia.it"
              target="_blank" moz-do-not-send="true">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" moz-do-not-send="true">www.itopen.it</a>
            <<a href="http://www.itopen.it" rel="noreferrer"
              target="_blank" moz-do-not-send="true">http://www.itopen.it</a>>
            <<a href="http://www.itopen.it" rel="noreferrer"
              target="_blank" moz-do-not-send="true">http://www.itopen.it</a>><br>
            >     ><br>
            >     >
            _______________________________________________<br>
            >     > Qgis-psc mailing list<br>
            >     > <a href="mailto:Qgis-psc@lists.osgeo.org"
              target="_blank" moz-do-not-send="true">Qgis-psc@lists.osgeo.org</a>
            <mailto:<a href="mailto:Qgis-psc@lists.osgeo.org"
              target="_blank" moz-do-not-send="true">Qgis-psc@lists.osgeo.org</a>><br>
            >     > <a
              href="https://lists.osgeo.org/mailman/listinfo/qgis-psc"
              rel="noreferrer" target="_blank" moz-do-not-send="true">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" moz-do-not-send="true">www.faunalia.eu</a>
            <<a href="http://www.faunalia.eu" rel="noreferrer"
              target="_blank" moz-do-not-send="true">http://www.faunalia.eu</a>><br>
            >     <a href="http://QGIS.ORG" rel="noreferrer"
              target="_blank" moz-do-not-send="true">QGIS.ORG</a> <<a
              href="http://QGIS.ORG" rel="noreferrer" target="_blank"
              moz-do-not-send="true">http://QGIS.ORG</a>> Chair:<br>
            >     <a
              href="http://planet.qgis.org/planet/user/28/tag/qgis%20board/"
              rel="noreferrer" target="_blank" moz-do-not-send="true">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" moz-do-not-send="true">Qgis-psc@lists.osgeo.org</a>
            <mailto:<a href="mailto:Qgis-psc@lists.osgeo.org"
              target="_blank" moz-do-not-send="true">Qgis-psc@lists.osgeo.org</a>><br>
            >     <a
              href="https://lists.osgeo.org/mailman/listinfo/qgis-psc"
              rel="noreferrer" target="_blank" moz-do-not-send="true">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" moz-do-not-send="true">www.itopen.it</a>
            <<a href="http://www.itopen.it" rel="noreferrer"
              target="_blank" moz-do-not-send="true">http://www.itopen.it</a>><br>
            <br>
            -- <br>
            Paolo Cavallini - <a href="http://www.faunalia.eu"
              rel="noreferrer" target="_blank" moz-do-not-send="true">www.faunalia.eu</a><br>
            <a href="http://QGIS.ORG" rel="noreferrer" target="_blank"
              moz-do-not-send="true">QGIS.ORG</a> Chair:<br>
            <a
              href="http://planet.qgis.org/planet/user/28/tag/qgis%20board/"
              rel="noreferrer" target="_blank" moz-do-not-send="true">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"
            moz-do-not-send="true">www.itopen.it</a></div>
      </div>
      <br>
      <fieldset class="mimeAttachmentHeader"></fieldset>
      <pre class="moz-quote-pre" wrap="">_______________________________________________
Qgis-psc mailing list
<a class="moz-txt-link-abbreviated" href="mailto:Qgis-psc@lists.osgeo.org">Qgis-psc@lists.osgeo.org</a>
<a class="moz-txt-link-freetext" href="https://lists.osgeo.org/mailman/listinfo/qgis-psc">https://lists.osgeo.org/mailman/listinfo/qgis-psc</a></pre>
    </blockquote>
    <pre class="moz-signature" cols="72">-- 
Marco Bernasocchi

QGIS.org Co-chair
<a class="moz-txt-link-freetext" href="http://berna.io">http://berna.io</a></pre>
  </body>
</html>