Hi Sivan, Your ideas are, of course, much appreciated. I have seen so many worthy projects that dwindle and die due to a lack of good documentation and user support. Remember that there a lot of talented programmers out there that would love to take advantage of pyside to program Qt with Python. Many of them, however, will bail in a hurry if there is not a straight forward way for them to get the environment setup, and some good simple tutorials to show what the capabilities are. I have been following the progress of Pyside since it was first announced, wondering if it would live up to its promise. I think we can say at this point that the answer is definitely yes! The release of the Windows binaries the other day has me excited that this project will go all the way and provide an easy programming environment setup for developers who just want to get started writing their application with a great toolkit. If you do it right, your contributions will encourage users to play with the code, more people will submit bug reports and feature requests, and pyside will get better! Documentation is the first thing I look for when deciding which open source library I am going to include in a project.
thanks Brian On Sat, Sep 4, 2010 at 9:31 AM, Sivan Greenberg <[email protected]> wrote: > Hi list, > > Finally, my weekends became more free than before and I can go back > to my (ambitious! ;)) initiative to provide better documentation for > the project. > > Googling around I see that most of the tutorials are either very > short with too much advanced details that might scare a new comer, on > the other hand the auto- generated reference documentation is rather > for those who have been either developing with Qt or PyQt for a while > and know exactly what they want. > > I have two main main goals: > > 1) Create an official tutorial, concentrating on the competitive edge > in rapid development and prototyping that PySide offers. This will > include setting up a development environment (with notes provided to > me here on the ML not long ago by some generous people of the mailing > list), setup from either source/git or provided packages on 2 desktop > platforms (Ubuntu and MeeGo). In order to emphasis the rapid > development I would like to demonstrate how to use PySide + QML for > fastest prototyping. > > 2) Create a "cookbook". So for each functionality incorporated from > Qt proper, I would like us to have a PySide example app or recipe. > Examples are "creating a web enabled app", a "service consuming app" , > a multimedia app, a "location based client server app" etc. Where a > complete recipe does not apply, we should at least provide a small > example. We could borrow from the Qt examples as they are if > applicable as I think Matti has started to do to some extent. > > So, for the PySide +QML (+MTF) bit I'd like to ask for bits of > guidance and/or references as while looking for this I found only very > small bits or mostly the QML parsing engine bindings reference in > PySide. > > Other than that- how does the whole idea sound? Any feedback and > suggestions are welcome as I want this to become as useful as > possible. > > BR, > > -Sivan > _______________________________________________ > PySide mailing list > [email protected] > http://lists.openbossa.org/listinfo/pyside > -- Duff
_______________________________________________ PySide mailing list [email protected] http://lists.openbossa.org/listinfo/pyside
