Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

qt6book/edit/main/docs/ch04-qmlstart/layout.md -- no definition of custom QML components GreenSquare and BlueSquare #205

Open
zefreelance2012 opened this issue Oct 4, 2022 · 0 comments

Comments

@zefreelance2012
Copy link

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. 😊

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

No branches or pull requests

1 participant