[Interest] making qt examples more verbal

[Tero.Aijala at nokia.com]

Hi,

On 11.11.2011 9.05, "ext alex.blasche at nokia.com" <alex.blasche at nokia.com>
wrote:

>It's a slow Friday. I put the initial version of
>weatherinfo_with_location into gerrit:
>
>http://codereview.qt-project.org/#change,8662
>
>It's a quick port. The GraphicsView dependencies should probably be
>removed at some stage and of course there are no docs at this stage.
>
>--
>Alex
>
>>-----Original Message-----
>>From: interest-bounces+alex.blasche=nokia.com at qt-project.org
>>[mailto:interest-bounces+alex.blasche=nokia.com at qt-project.org] On Behalf
>>Of Blasche Alex (Nokia-MP-Qt/Brisbane)
>>Sent: Friday, 11 November 2011 15:26
>>To: sivan at omniqueue.com; interest at qt-project.org
>>Subject: Re: [Interest] making qt examples more verbal
>>
>>
>>
>>>-----Original Message-----
>>>From: interest-bounces+alex.blasche=nokia.com at qt-project.org
>>>[mailto:interest-bounces+alex.blasche=nokia.com at qt-project.org] On
>>Behalf
>>>Of ext Sivan Greenberg
>>
>>>Having those would already make the examples good as recipes, later on
>>>adding full commentary for the important code snippets from an
>>>example, would enable more granular searching for terms and code
>>>snippets through the Qt Creator example browser.
>>>
>>>Does this make sense? Is it worth a bug report to track working on it?
>>
>>It certainly makes sense.
>>
>>I would like to redirect your attention to the Qt5 documentation. Most
>>of our
>>effort goes there. The mobility docs won't receive any changes unless
>>absolutely required (bugs, false statements etc). The Qt5 location
>>documentation is currently undergoing major revamps. The current entry
>>point is:
>>
>>http://doc.qt.nokia.com/qt5-snapshot/qtlocation-module.html
>>
>>I hope the URL is public. Otherwise you can simply generate it from the
>>repo
>>("make online_docs" in qtdoc).
>>
>>Because this revamp is ongoing I'd argue that there is no point in
>>reporting
>>bugs quite yet as the content is changing by the day. However what does
>>work are Gerrit contributions. They can be easily integrated and track
>>the
>>latest revision.

We are indeed working actively on Qt5, but we should also acknowledge that
Qt Mobility 1.2 is the latest release that can actually be used for
developing for the N9 and Symbian. IMHO if we can help the developers
targeting the devices out there, we should do that. Qt5 docs do not help
with that effort too much.

So, if you do have interest in helping with the existing docs, we will
figure out how to get those out there. For example via Devnet.

What we need to make sure of is that any work done with the existing stuff
get's migrated to Qt5 side when applicable.

Br,

Tero


>>
>>--
>>Alex
>>_______________________________________________
>>Interest mailing list
>>Interest at qt-project.org
>>http://lists.qt-project.org/mailman/listinfo/interest
>_______________________________________________
>Interest mailing list
>Interest at qt-project.org
>http://lists.qt-project.org/mailman/listinfo/interest