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. On Wednesday 19 January 2011 05:06:21 João Ventura wrote: > Hi Matti Airas, > > i've just started to contribute two wiki pages: How to set up > PySide (refering to downloads) and how to create a simple > hello world. You can check both on the Documentation and in > http://developer.qt.nokia.com/wiki/Setting_up_PySide and > http://developer.qt.nokia.com/wiki/Hello_World_in_PySide > > I've followed you suggestion about keeping PySide in the > names and the category markup! I seem to have encountered a > problem, which is not really a problem, but more of a > feature. When i go through Documentation to any other page, > i see that that page is accessed through > "PySideDocumentation" but it is not son of > "PySideDocumentation". It think that "PySideDocumentation" > should be transformed into a category, and that anything > under it should be "sons" of that category. I tried to do > it, i.e., i've created the category but i can't redirect the > wiki page "PySideDocumentation" to the newly created > "PySideDocumentation" category. The reason is that i don't > want to break existing links to the "PySideDocumentation" > page. Do you have any idea how to do it? > > I won't try to do it by trial and error again, to not pollute > the wiki with "zombi" wiki pages. > > Perhaps someone should plan the documentation structure. I > propose something like: > - Getting started > - how to set up PySide > - how to start using it > - how to make some simple things > - Tutorials > - Signals and Slots > - how to use it > - new types of signals > - ... > - Others things (which things? - i am merely a beginner) > - API reference > - etc.. > > Each of the "top" things, if it will have "sons" should be a > category instead of a page. Makes more easy to navigate in > the wiki menus.. If no one objects, and while time permits, > i will be doing this.. > > > Thanks, > João Ventura -- Algis http://akabaila.pcug.org.au _______________________________________________ PySide mailing list [email protected] http://lists.openbossa.org/listinfo/pyside
