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
On 18 Jan, 17:09, Matti Airas <[email protected]> wrote:
> Hi, João!
>
> I guess I made the initial wiki doc layout when migrating our existing
> docs from the pyside.org website to the wiki. My hope was to encourage
> participation in creating missing documentation (and maintaining
> existing, of course). I've been happy to see people contribute quite a
> bit of stuff there, but indeed, we're still woefully short on newbie
> docs (despite e.g. some good initial efforts by Al Kabaila). Also, the
> wiki doc organization is indeed quite bad. If you're interested in
> working on them, that'd be just great!
>
> A couple of practical remarks:
>
> - When creating new pages, try to include "PySide" or "Python" in the
> page name (we share the wiki with other Qt developers)
>
> - Add any new pages to the PySide category by adding the following tag
> to the top of the page: [[Category:LanguageBindings::PySide]]
>
> - Currently, regular users can't rename pages on the wiki. If you need
> to do that, copy the contents over to the new page, and then report the
> old page to the admins (by pressing the Report button) for deletion.
> They've been quite patient with my requests so far. :-)
>
> Glad that you're willing to work on this!
>
> Cheers,
>
> ma.
>
> P.S. Just noticed the PySide main wiki page [1] has already been
> translated to Spanish, (Dirty?) Hungarian, and Italian. Wonder when we
> get the Portuguese translation? ;-D
>
> [1]http://developer.qt.nokia.com/wiki/Category:LanguageBindings::PySide
>
> On 18.01.2011 17:47, ext João Ventura wrote:
>
>
>
> > Hello everyone,
>
> > is anyone here responsible for the documentation in the PySide wiki?
>
> > The reason is that PySide is reaching version 1.0 pretty soon, and i
> > think it should be better documented for newbies and beginners like
> > me. For instance, when i've decided to go with PySide for my projects
> > (about 3 weeks ago), i've started to search for pyside tutorials and
> > as i couldn't find much, i had to search for PyQt things. I've
> > followed some examples, but it has cost me too much time searching for
> > something to start. Now i have the problem of searching how to do
> > start working with qml and pyside. So, the same kind of things
> > happening twice is really bad.
>
> > So, the reasoning that i'm asking if there is a responsible for the
> > wiki Documentation is that i would like to contribute some things, but
> > i don't want to mess with other people's work. I have already written
> > a wiki page "Setting up PySide" (http://developer.qt.nokia.com/wiki/
> > Setting_up_PySide) with some basic information that took me almost 1
> > hour to search in the first time. And i would also like to reorganize
> > some things that has to do with tutorials for beginners, if everyone
> > agrees?!
>
> > The two main reasons that i want to contribute something is that i
> > believe that good documentation for beginners is essential for a
> > project like this, and because i am a beginner.
>
> > Thanks,
> > João Ventura
> > _______________________________________________
> > PySide mailing list
> > [email protected]
> >http://lists.openbossa.org/listinfo/pyside
>
> _______________________________________________
> PySide mailing list
> [email protected]http://lists.openbossa.org/listinfo/pyside
_______________________________________________
PySide mailing list
[email protected]
http://lists.openbossa.org/listinfo/pyside
