<div dir="ltr"><div>Hi Denis,</div><div><br></div><div>Thanks a lot for your work.</div><div><br></div><div>I will put something in next years budget for maintenance/development of PyQGIS docs. I agree that this work is important and useful to our devs and users. If I forget about this in next year's budget, please remind me.</div><div><br></div><div>Budget will be up to discussion next year anyway.</div><div><br></div><div>Thanks,</div><div>Andreas<br></div></div><br><div class="gmail_quote"><div dir="ltr" class="gmail_attr">On Wed, 16 Oct 2019 at 09:40, Denis Rouzaud <<a href="mailto:denis.rouzaud@gmail.com">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">Dear PSC, <div><br></div><div>I have spent the 3 days on improving the PyQGIS docs.</div><div>Here is what has been done:</div><div><br></div><div>* refactoring of the build scripts (much clearer now)</div><div>* updating the forked theme (to support versioning) with upstream</div><div>* added processing to the documentation (still some work to be done here)</div><div>* remove empty sections (enum, signal, attributes) in pages  <a href="https://github.com/qgis/pyqgis/pull/40" target="_blank">https://github.com/qgis/pyqgis/pull/40</a></div><div>* add return types and param rtype (and links within the API docs) <a href="https://github.com/qgis/pyqgis/pull/41" target="_blank">https://github.com/qgis/pyqgis/pull/41</a></div><div><br></div><div>The last one was a tricky one. We currently cannot use existing tools (like sphinx-auto-typehints) since SIP does not fill the __annotations__ dictionary. Maybe another reason to look towards Qt for Python. Anyway, I added custom event handler around autodoc to manually process the docstring.</div><div><br></div><div>I believe this was a good shot for the docs, and I guess we would benefit from having such maintenance and small improvements sponsored work each year. Of course, I'm blowing my own horn, and I'd like to propose my application for next year. </div><div><br></div><div>Thanks for your confidence.</div><div>Denis</div><div><br></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><br clear="all"><br>-- <br><div dir="ltr" class="gmail_signature"><div dir="ltr"><div><br>--<br>Andreas Neumann<br></div><a href="http://QGIS.ORG" target="_blank">QGIS.ORG</a> board member (treasurer)<br></div></div>