Qt Quick best practices wiki page

Wolf P.

Looks good :-)
Maybe mandatory rules like "uniqueness of the id property":http://doc.qt.nokia.com/4.7/qdeclarativeintroduction.html#the-property could be separated. Are there already conventions about indentation and commenting style? Loking on the link above 4 spaces plus line end comments seems to be preferred.

BTW: is there a way to subscribe to wiki changes?

? Offline

good suggestions @Wolf P. will update

there is a "Recent Changes" link in the Wiki Menu on the Wiki main page. You could subscribe to that RSS feed, but I think that pushes only newly added pages and not on every edit.

Wolf P.

[quote author="chetankjain" date="1291107334"]You could subscribe to that RSS feed, but I think that pushes only newly added pages and not on every edit.[/quote]

Oh thanks! I looked rather for a notification mail service as provided for the forum.

? Offline

for mail notification for wiki page entries, you could raise a request for that new feature to be implemented, in the beta forum of devnet

? Offline

just updated the wiki page with more contents

Wolf P.

Fine. Is the top-level order intended?

I would disagree with your examples of comments. Let me try some editing there...

? Offline

[quote author="Wolf P." date="1291117880"]Fine. Is the top-level order intended?

I would disagree with your examples of comments. Let me try some editing there...[/quote]

yes pls go ahead :) the aim is to collate all the best practices and I am still learning too :D

Wolf P.

...ready.

Sorry, I found the block end comments questionable.

? Offline

The example looks ok.

I moved the 2 bullets talking about comments to the "Open for discussion" section... lets see what everyone has to say. Maybe we could have a poll later on these topics. Else the trolls could also have a final word :)

xsacha

How about some DOs / DONTs for cross-platform QtQuick?

What about using fixed size width, height, x, y vs anchors/locations. Fixed sizes seem overused, even in the examples.

Also, if you don't specify a font size, it could be anything it seems. Even if it looks fine on one platform, it be quite different on another unless you specify. Important to consider.

Wolf P.

DONTs are a good idea i find. What about starting an own wiki page for it? I'll help as I can.
I suggested the title "Qt Quick Donts":http://developer.qt.nokia.com/wiki/Qt_Quick_Donts on the best practices page.

Happy wikiing :)

xsacha

So should the cross-platform (i.e. cross-resolution) DONTs go in there? You should always try to make your code cross-platform I think. Especially important to learn from the start. However, I'm not so sure on how important it is to make the QML rotatable.

It's quite amazing when you do the right practices and your code works on devices you've never even seen before.
There was a nice app on Qt-Apps made in QML for Linux Desktop. Worked perfect on Symbian devices even though the developer had never used or seen one.

Wolf P.

[quote author="xsacha" date="1291282464"]So should the cross-platform (i.e. cross-resolution) DONTs go in there? You should always try to make your code cross-platform I think. Especially important to learn from the start. However, I'm not so sure on how important it is to make the QML rotatable.[/quote]

If it is actually possible to write platform dependend QML, then I think that it should be included (sorry I'm not an experienced QML developer, I tried hacking some examples up to now)

I find the idea of the reverse style so appealing. :)

xsacha

I have often seen in code (for example the Twitter app in SDK), they use specific font sizes and widths.
I ran it on Windows, looks fine. Though, the app is clearly designed for a mobile device with its small space constraints. So I tried it on Symbian, hideous. I spent a day fixing it up and it looks great now.

It's funny because they admit this in the code. I saw a comment that they should use anchors instead. Definitely wiki material.

Wolf P.

I'd highly appreciate if you would start the wiki page.

xsacha

[quote author="Wolf P." date="1291293375"]I'd highly appreciate if you would start the wiki page.[/quote]
Alright, I started that page. I mentioned the fixed size vs anchors point.

Wolf P.

:) Great! (I immediately made some minor changes.)

? Offline

this has since been added as a "suggestion":http://bugreports.qt.nokia.com/browse/QTBUG-15757 in the Qt bug tracker and seems to be accepted, so we might see an official version soon ...

have also added a few more points in the wiki page ..

ps. a tag is missing for this post ? ;-)