<![CDATA[What's up with the awful documentation?]]>Hey, I'm new to Qt for Python, just trying to follow the docs to create a TreeView + model... But the documentation is so incredibly broken? In what universe is this sort of thing valid Python or C++ or anything else for that matter? And it seems this one page of the docs is far from the only one with this sort of mess in the snippets. It makes the whole documentation borderline useless. Are there any non-broken resources I can use to learn this? Thanks.

]]>https://forum.qt.io/topic/138547/what-s-up-with-the-awful-documentationRSS for NodeTue, 28 Apr 2026 14:04:03 GMTFri, 12 Aug 2022 07:00:30 GMT60<![CDATA[Reply to What's up with the awful documentation? on Fri, 12 Aug 2022 15:25:10 GMT]]>Hi, and welcome!

@hanetar said in What's up with the awful documentation?:

the documentation is so incredibly broken?

Thanks for reporting this. I've created a bug report for the issues seen in this snippet: https://bugreports.qt.io/browse/PYSIDE-2030

See the comments at https://bugreports.qt.io/browse/PYSIDE-1952 for some insight to why such brokenness exists.

Are there any non-broken resources I can use to learn this?

Try searching for tutorials that are written specifically for Python, rather than those that were auto-converted from C++.

I haven't gone through it in detail myself, but this one looks like it was done with care: https://www.pythonguis.com/pyside6-tutorial/ (although personally, I wouldn't touch threads so early in the series)

]]>https://forum.qt.io/post/724669https://forum.qt.io/post/724669Fri, 12 Aug 2022 15:25:10 GMT