<p dir="ltr">I'm not sure we need the headers in the sip files to make a python docs API do we. That is the first thing to work out.</p>
<br><div class="gmail_quote"><div dir="ltr">On Wed, 8 Mar 2017 6:23 pm Alessandro Pasotti <<a href="mailto:apasotti@gmail.com">apasotti@gmail.com</a>> wrote:<br></div><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex"><div dir="ltr" class="gmail_msg"><div class="gmail_msg"><div class="gmail_msg"><div class="gmail_msg"><div class="gmail_msg"><div class="gmail_msg"><div class="gmail_msg"><div class="gmail_msg">Hi,<br class="gmail_msg"><br class="gmail_msg"></div>I think we still lack a up-to-date comprehensive documentation targeted to Python QGIS developers and I would like to discuss the options that we have to improve the current situation.<br class="gmail_msg"><br class="gmail_msg"></div>As a Python QGIS developer, what I probably need is:<br class="gmail_msg"></div>1. Python API docs, possibly with examples<br class="gmail_msg"></div>2. Developer documentation about how to write PyQGIS plugins and standalone applications<br class="gmail_msg"></div>3. Tutorials and examples<br class="gmail_msg"></div>4. Scaffolding<br class="gmail_msg"><br class="gmail_msg"></div><div class="gmail_msg"><br class="gmail_msg"></div>2 and 3. the cookbook is doing a very good job, but it could probably be improved and kept in sync with the API changes<br class="gmail_msg">4. is perfectly covered by plugin builders<br class="gmail_msg"><div class="gmail_msg"><div class="gmail_msg"><div class="gmail_msg"><div class="gmail_msg"><div class="gmail_msg"><div class="gmail_msg"><div class="gmail_msg">1. this is were IMO we should do better: for most experienced QGIS developers it's perfectly fine to look at the C++ API docs, but I think that for Python developers that is not ideal<br class="gmail_msg"><br class="gmail_msg"></div><div class="gmail_msg">There have been some efforts to build PyQGIS API documentation: <a href="http://geoapis.sourcepole.com/qgispyapi/qgisinterface" class="gmail_msg" target="_blank">http://geoapis.sourcepole.com/qgispyapi/qgisinterface</a> , maybe Sourcepole colleagues could share their experience in building that pages.<br class="gmail_msg"><br class="gmail_msg"></div>My main concern here is that we are slowly moving away from documenting SIP files, I don't know if we can still build PyQGIS documentation without documenting the SIP files but we should think carefully before taking a move that will block us from using SIP files as a source for building the docs.<br class="gmail_msg"><br class="gmail_msg"><br class="gmail_msg"></div><div class="gmail_msg">What do you think about this?<br class="gmail_msg"></div><div class="gmail_msg"><br clear="all" class="gmail_msg"></div><div class="gmail_msg"><div class="gmail_msg"><div class="gmail_msg"><div class="gmail_msg"><br class="gmail_msg">-- <br class="gmail_msg"><div class="m_-8898174341362392353gmail_signature gmail_msg">Alessandro Pasotti<br class="gmail_msg">w3:   <a href="http://www.itopen.it" class="gmail_msg" target="_blank">www.itopen.it</a></div>
</div></div></div></div></div></div></div></div></div></div>
_______________________________________________<br class="gmail_msg">
Qgis-developer mailing list<br class="gmail_msg">
<a href="mailto:Qgis-developer@lists.osgeo.org" class="gmail_msg" target="_blank">Qgis-developer@lists.osgeo.org</a><br class="gmail_msg">
List info: <a href="https://lists.osgeo.org/mailman/listinfo/qgis-developer" rel="noreferrer" class="gmail_msg" target="_blank">https://lists.osgeo.org/mailman/listinfo/qgis-developer</a><br class="gmail_msg">
Unsubscribe: <a href="https://lists.osgeo.org/mailman/listinfo/qgis-developer" rel="noreferrer" class="gmail_msg" target="_blank">https://lists.osgeo.org/mailman/listinfo/qgis-developer</a></blockquote></div>