<div dir="ltr">In the docs meeting we have talked about splitting/removing the python cookbook from the User manual (the same for other sections).<div><br></div><div>The advantages would be:<br><br>- We can release each document in separate<div>- We can break one of the docs without breaking the others</div><div>- we can have the cookbook more developers-oriented (even in the way it's written)</div></div><div><br></div><div>The disadvantages would be:</div><div>- We would need to set intersphinx in both projects to allow keep cross linking between them</div><div>- we would need to duplicate our sphinx project structure, and maintain it (themes, makefiles, CI, etc...)<br>- If we want to go with translation, we would need to set other transifex projects (at the meeting we kinda talked about the real need for translation for the cookbook, quickly browsing excelpt for spanish and french, most of other languages don't have it translated)<br><br></div><div>But anyway, like Alessandro said, the work that needs to be done, can be performed in any of the repositories.</div><div><br></div><div>Alexandre Neto</div></div><br><div class="gmail_quote"><div dir="ltr" class="gmail_attr">On Fri, Dec 20, 2019 at 11:29 AM Alessandro Pasotti <<a href="mailto:apasotti@gmail.com">apasotti@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"><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" target="_blank">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="gmail-m_-5435793791394502617plusReplyChip-1" href="mailto:denis.rouzaud@gmail.com" target="_blank">@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">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>