<div dir="ltr"><div dir="ltr"><br></div><br><div class="gmail_quote"><div dir="ltr" class="gmail_attr">On Fri, Dec 20, 2019 at 12:22 PM DelazJ <<a href="mailto:delazj@gmail.com">delazj@gmail.com</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"><div dir="ltr"><div dir="ltr"><div>Hi all,</div><div><br></div><div>Quick points<br></div></div></div></blockquote><div></div><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left:1px solid rgb(204,204,204);padding-left:1ex"><div dir="ltr"><div class="gmail_quote"><div dir="ltr" class="gmail_attr">Le ven. 20 déc. 2019 à 11:54, Alessandro Pasotti <<a href="mailto:apasotti@gmail.com" target="_blank">apasotti@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"><div dir="ltr"><div dir="ltr"><br></div>[...]<br><div><br></div><div>Whether the whole Python developers guide (cookbook + API) is an external link or not is probably not so important, except maybe for browsability from the main website and search capabilities from the main website.</div><div><br></div></div></blockquote><div>The intersphinx  extension helps to reach Python API documentation from within the Cookbook or the User manual. The reverse is not (yet?) true and I don't know whether it's easy to do.</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"><div dir="ltr"><div></div><div>Both the Python part and the C++ part are actually a mix of three separate topics: <br></div><div>- core development (C++ and core Python plugins and processing core algs) <br></div><div>- independent plugins (both C++ even if they are not very welcome lately and Python).</div><div>- standalone applications <br></div><div><br></div><div>In any event, if I get this right, moving the cookbook to a different sphinx project doesn't change much about the cookbook revision work I'm proposing to do, we can probably just move the doctest target into the python API project.</div><div><br></div><div>But I wonder if moving the cookbook out of the documentation doesn't create a problem with translations, I didn't check if there are any for the cookbook.</div><div><br></div></div></blockquote><div>Every document under qgis/QGIS-Documentation repository is currently translated.</div></div></div></blockquote><div><br></div><div><br></div><div>Hm, so I guess this is a blocker, right?<br></div><div><br></div><div><a class="gmail_plusreply" id="plusReplyChip-1" href="mailto:denis.rouzaud@gmail.com" tabindex="-1">@Denis Rouzaud</a>  given that the system to run CI tests on the Python code embedded in the cookbook is already in place, what are the technical advantages of moving the cookbook into the Python API sphinx project?</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"><div dir="ltr"><div class="gmail_quote"><div><br></div><div>Regards,</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"><div dir="ltr"><div></div><div>I think we should bring the documentation team into the discussion, is there a better place than this list where they have a better chance to get involved?<br></div><div><br></div><div>Cheers<br></div><div><br></div>-- <br><div dir="ltr">Alessandro Pasotti<br>w3:   <a href="http://www.itopen.it" target="_blank">www.itopen.it</a></div></div>
_______________________________________________<br>
Qgis-psc mailing list<br>
<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></blockquote></div></div>
</blockquote></div><br clear="all"><br>-- <br><div dir="ltr" class="gmail_signature">Alessandro Pasotti<br>w3:   <a href="http://www.itopen.it" target="_blank">www.itopen.it</a></div></div>