link : https://doc.qt.io/qt-6/bindableproperties.html#bindable-property-getters-and-setters

The section above, especially the two secsions inside "Bindable Property Getters" and "Bindable Property Setters" are hard to understand just by reading the descriptions.

For example, "Bindable Property Getters" says "every possible code path in a getter needs to read from the underlying property object." but it's unclear what exactly "underlying property object" means and also what other things are there which one can read a value from.
Same kind of unclarity exists in "Bindable Property Setters" as well.

I think it's be better to have "a good example" where the code is doing the right thing and "bad examples" where the code is doing the thing in a way it's not supposed to.

Examples would make it much more clear. Making it clear to as many programmers as possible, including junior level developers, should have a positive impact on the prosperity of Qt.