<div dir="ltr">

<div dir="ltr"><div dir="ltr"><div></div></div></div><div class="gmail_quote"><div dir="ltr">On Fri, Sep 28, 2018 at 11:38 AM Phil Thompson <<a href="mailto:phil@riverbankcomputing.com">phil@riverbankcomputing.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"><br>
<br>
Any feedback and suggestions for improvement are welcome.<br>
<br><br></blockquote></div><br clear="all">
<div>Hi Phil,</div><div><br></div><div>I agree it's a big improvement. Thank you. <br></div><div><br></div><div>I
 
have a simple suggestion: make the  "use the latest version of PyQt5 no 
matter what version of Qt v5 you are using" much more visible. It's 
buried at the moment. For example, even a minor change like rewording 
"An Explanation of Version Numbers" to "Understanding the Correct 
Version to Install" would make it much clearer to the uninitiated.</div><div><br></div><div>Damon<br></div><div><br></div>

<br>-- <br><div dir="ltr" class="gmail_signature"><a href="http://www.damonlynch.net" target="_blank">http://www.damonlynch.net</a></div>



</div><br><div class="gmail_quote"><div dir="ltr">On Fri, Sep 28, 2018 at 11:38 AM Phil Thompson <<a href="mailto:phil@riverbankcomputing.com">phil@riverbankcomputing.com</a>> wrote:<br></div><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">I've made a new release of the PyQt documentation at...<br>
<br>
<a href="https://pyqt.readthedocs.io" rel="noreferrer" target="_blank">https://pyqt.readthedocs.io</a><br>
<br>
This is the first stage of creating complete PyQt5 documentation (similar to what was done with the PyQt4 documentation).<br>
<br>
The documentation is created from 4 sources:<br>
<br>
- "static" text files<br>
- .sip files that provide the objects (modules, classes, enums etc) being documented with hooks<br>
  for "description files"<br>
- the Qt source code which provide the initial content of the description files<br>
- the description files which will be updated over time (a long time!) to become more Pythonic<br>
  as required.<br>
<br>
The system is designed so that it can be updated with new PyQt and Qt releases without losing any user-written changes to the description files.<br>
<br>
For the moment the description files are just stubs (lots of TODOs) because I wanted feedback on the overall structure before populating it from the Qt documentation.<br>
<br>
There are lots of outstanding issues that will be addressed over time. For example, nested classes are only referenced from the class index (mainly an issue for the classes that implement enum flags).<br>
<br>
Any feedback and suggestions for improvement are welcome.<br>
<br>
Phil<br>
_______________________________________________<br>
PyQt mailing list    <a href="mailto:PyQt@riverbankcomputing.com" target="_blank">PyQt@riverbankcomputing.com</a><br>
<a href="https://www.riverbankcomputing.com/mailman/listinfo/pyqt" rel="noreferrer" target="_blank">https://www.riverbankcomputing.com/mailman/listinfo/pyqt</a></blockquote></div><br clear="all"><br>-- <br><div dir="ltr" class="gmail_signature" data-smartmail="gmail_signature"><a href="http://www.damonlynch.net" target="_blank">http://www.damonlynch.net</a><div></div><div></div><div></div></div>