<div dir="auto"><div>Hi Ale,<div dir="auto"><br></div><div dir="auto">Sorry for not being clear.</div><br><br><div class="gmail_quote"><div dir="ltr" class="gmail_attr">Le jeu. 19 déc. 2019 à 16:59, Alessandro Pasotti <<a href="mailto:apasotti@gmail.com">apasotti@gmail.com</a>> a écrit :<br></div><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex"><div dir="ltr"><div dir="ltr"><br></div><br><div class="gmail_quote"><div dir="ltr" class="gmail_attr">On Thu, Dec 19, 2019 at 4:41 PM Denis Rouzaud <<a href="mailto:denis.rouzaud@gmail.com" target="_blank" rel="noreferrer">denis.rouzaud@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">Hi all,<div><br></div><div>I was wondering if the cookbook could be integrated with the API docs website.</div><div>It would be nice, we could test everything there (it uses the QGIS docker images), and it would have a single coherente endpoint.</div><div><br></div><div>Ale, feel free to get in touch :)</div><div><br></div><div>Denis</div></div></blockquote><div><br></div><div>Hi Denis,</div><div><br></div><div>Do you you mean adding the cookbook directly in the C++ class headers? Like <a href="https://github.com/qgis/QGIS/blob/master/src/server/qgsserverogcapi.h#L33" target="_blank" rel="noreferrer">https://github.com/qgis/QGIS/blob/master/src/server/qgsserverogcapi.h#L33</a> ?</div><div><br></div><div>This is what QT does, right?</div><div><br></div><div>If that's the case, I've thought about it and there are certainly some advantages: the most important one would probably be a unique source for code, API docs, PyQgis API docs and PyQgis recipes (the cookbook). <br></div><div>I'm not against it, but I'm not really sure it's the best option: I see the cookbook more like a "book", where there might be more space for longer paragraphs, pictures etc. and where the content can be organized independently from the Qgs* classes structure. <br></div><div><br></div><div>There are also sections in the cookbook that span across classes (the snippets mainly) or that do not really map to a single Qgs class.</div></div></div></blockquote></div></div><div dir="auto"><br></div><div dir="auto"><br></div><div dir="auto">Yeah, I'm totally with you here. While it sounds like a clever idea at first, you hit so many issues like this which will just make the work much harder at the end.</div><div dir="auto"><div class="gmail_quote"><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex"><div dir="ltr"><div class="gmail_quote"><div></div><div><br></div><div>In any event, the cookbook also uses a QGIS docker image for the python code tests (qgis/qgis:latest).</div><div><br></div><div>But maybe I totally misunderstood your proposal and you are just talking about moving the current cookbook content into another repo or suck it up when building PyQGIS API docs.<br></div></div></div></blockquote></div></div><div dir="auto"><br></div><div dir="auto"><br></div><div dir="auto">Yes, I have 2 points:</div><div dir="auto">* Build the API docs and the cookbook in the same job (but I don't care that much if not)</div><div dir="auto">* Bring the cookbook under the same website as <a href="http://qgis.org/pyqgis">qgis.org/pyqgis</a> so we have a single entry for all python related stuff.</div><div dir="auto"><br></div><div dir="auto">Cheers</div><div dir="auto">Denis</div><div dir="auto"><br></div></div>