Hi Algis Kabaila, i agree with you and also i like things simple. When someone is searching for how to do something, most of the times that person is in a hurry and doesn't care about the "bla bla bla" and just wants to start coding. That's why i believe there must exist tutorials for real beginners like that example of the Hello World.
But i think we should consider using the categories in the wiki, because the wiki gives a kind of menu above the contents where the user can "see" where he is, and it contextualizes things. See, for example, this page http://developer.qt.nokia.com/wiki/Generating_new_bindings_with_PySide/ and you will see that it comes from a category called Shiboken which is "son" of PySide category. I think that in some situations, your approach (without categories) is more important, in other situations, having the pages in categories is easy for the "navigation" in the wiki. We just have to see where each one applies as things get done. But, the parent-child approach i believe it is the best Also, i pretend to structure today the documentation pages. It will change to something like: - Getting started - Setting up - Yout first PySide application - Tutorials by experience level (Beginner, Intermediate, Advanced) - Tutorials by category (Desktop, mobility and QtQuick/QML) - API References - Examples - Bits and Pieces - Diferences between PySide and PyQt - PSEP's - Building - Generating Bindigs (will redirect to Shiboken) The idea is to keep the pages really clean, usable and structured. I'm in the mood for this, and will keep on doing until someone says it is starting to look awful (hope not)! Will take in consideration the ideas of Algis specially in the tutorial pages. Algis, i will insert the simplissimus and your page where i think it makes more sense, but if you agree with my changes and want to insert the examples in other way, you're welcome. Strange, i have the feeling that i've hijacked the wiki documentation. I'm pretty new around here, so if someone does not agree with my "interference", please alert me before i make any thing that the community doesn't agree! Thanks, João Ventura On 19 Jan, 05:03, Algis Kabaila <[email protected]> wrote: > Hi João Ventura, > > A structure in a wiki is a highly desirable feature. Like most > wiki's, the qt developer wiki has a "flat" file structure and > any attempt to structure it differently is by necessity shallow. > > I am a great believer in the KISS principle. The semblance of > structure can be achieved very simply without messing up the > category system by giving references to the "children" pages > from a "main" page and the back references to the main page from > the children page. > > A tiny start in that direction can be seen by going to > > http://developer.qt.nokia.com/wiki/PySide_Newbie_Tutorials > > and then visiting the children pages. If you find the approach > unsuitable, I would appreciate it if you air your concerns. > Negative but thoughtful cricisim is particularly appreciated. > > Kind regards, > Al. _______________________________________________ PySide mailing list [email protected] http://lists.openbossa.org/listinfo/pyside
