if there is a documentation snippet inside a QML element, like:

Item {
id: button
/*! \qmlproperty bool BLA::1.0::Button::checked

        If the button is checked, then \c checked is true. The property is set to
        \c false by default.

        Property default is false

*/
}

I would expect this checked property to appear in the Button docs, even if the property is not actually defined there.
this would give us much more fliexbility to workaround qtdoc current limitations.