New approach to tutorials

[troubalex]

Hello, target audience! :P

We have come up with a new way of sorting tutorials that spread over various articles. We were looking for a way of displaying them in a way that makes discovery of the tutorial simple and presents the sub-parts in the right order. At the same time, we wanted to make sure that users can jump right into the part they are looking for.

This is what we came up with, the "PySide Binding Generation Tutorial":http://developer.qt.nokia.com/wiki/Category:LanguageBindings::PySide::Shiboken::PySide_Binding_Generation_Tutorial served as a good example.

Let me know what you think. Is it obvious how it works?

[giesbert]

Hi,

if I saw it correct, you created a category, and inside the category sub pages, right?
But how to navigate between part 1 and part 2? always by going back to main?

Perhaps have a look at one tutorial that is getting created in German forum:

"Model view controller":http://developer.qt.nokia.com/groups/qt_german/wiki/Model_View_Tutorial

In this tutorial, the first page is too large, but that will change later, when all content is there, I will restructure it :-)

a combination of both could be good.

[goetz]

Hm, looks weird to me. The important content is on the bottom of the page and looks like some "additional reading" at best.

I personally would prefer an approach like in the "Qt Quick Tutorial":http://developer.qt.nokia.com/wiki/Qt_Quick_Tutorial with its introductory page and a short description of the contents along with the links to the sub pages.

[giesbert]

That looks good, yes.
I would just move navigation on top and bottom :-)

[troubalex]

Fair enough. I will tweak a bit and see how far I get. This week is going to be crazy busy but given that I survive I will have some more time for the wiki next week. :)

[Guest]

I really like the way java tutorials have been made available. you will have seen it: "http://download.oracle.com/javase/tutorial/":http://download.oracle.com/javase/tutorial/