Please excuse me and dismiss this issue if I'm wrong, but as far as I see qt6book/edit/main/docs/ch04-qmlstart/layout.md has no definition of custom QML components GreenSquare and BlueSquare.
I am guessing that these components are Rectangles which have a MouseArea with drag properties enabled. But I can't find any such definition on the page (or if I'm not wrong, on any other pages either).
This makes the entire page a little confusing (and perhaps a bit misleading too, especially to a person new to QML) because the reader has no idea what a GreenSquare or BlueSquare is. They might have questions like
Are these squares custom QML elements or standard elements provided by the framework?
How come a square has a text property?
If they are squares, then how come it has a width and height property? (case 4 with blue1 and blue2 squares)
But even if we somehow assume all this, the part which absolutely fails is the "Hidden Gems" section. One might ignore the questions asked above, but (without any definition) will have a very hard time figuring out how the "squares have been magically enhanced to enable dragging".
So I suggest:
we add the definitions of QML components GreenSquare and BlueSquare
if that's not possible promptly or at all, then at minimum remove the "Hidden Gems" section
If there's a way I can help expedite the process, please feel free to approach me. This is a great book and I'm highly interested in helping to make it even better. 😊
Please excuse me and dismiss this issue if I'm wrong, but as far as I see
qt6book/edit/main/docs/ch04-qmlstart/layout.mdhas no definition of custom QML componentsGreenSquareandBlueSquare.I am guessing that these components are
Rectangles which have aMouseAreawithdragproperties enabled. But I can't find any such definition on the page (or if I'm not wrong, on any other pages either).This makes the entire page a little confusing (and perhaps a bit misleading too, especially to a person new to QML) because the reader has no idea what a
GreenSquareorBlueSquareis. They might have questions liketextproperty?blue1andblue2squares)But even if we somehow assume all this, the part which absolutely fails is the "Hidden Gems" section. One might ignore the questions asked above, but (without any definition) will have a very hard time figuring out how the "squares have been magically enhanced to enable dragging".
So I suggest:
GreenSquareandBlueSquareIf there's a way I can help expedite the process, please feel free to approach me. This is a great book and I'm highly interested in helping to make it even better. 😊