Re: Fw: RE: gtk-tutorial-sources

On Monday 05 March 2001 10:59, Andrei Zmievski wrote: > I think we need to put a little thought into what actually should go > into PHP-GTK documentation. I mean, we probably would not want to > document every single GTK class (well, not unless someone has a lot of > free time). So, what should go into the docs that would help new and > existing users? No, we don't want to document every class and method, but I feel that we do need to provide good documentation on what classes and methods are supported and how to interpret the exisiting GTK docs for use with PHP. I know the Python/Qt project has done something along those lines. Also, the feeling I get from my short time on this list, is that the main audience for php-gtk are developers who, while they may be quite familar with PHP, are stepping into new territory when it comes to developing GUI applications. I would imagine that the concepts of msg-loops, events, signal handling and document/views are quite new to a lot of the people who will want to use this interface. I know it took me a while to grasp everything the first time I developed a gui app. One of the most valuable parts of the php project is the "annotated" manual. Espescially in the days before there were any books available. It would be nice if we implement something like that at some point along the road. One tentative structure: Installation HOWTO - System Requirements - Skills needs ??? - Installation on Linus (Gtk, PHP, PHP-GTK) - Installation on Win32 - How to use CVS - Sample programs - Common Problems and Solutions Distribution HowTO - Don't think we're there yet, but people are go want to be able to create apps and the distribute them to vaious clients... I know I will. Beginners Guide and Tutorials - Can use a lot from the GTK tutorials PHP_GTK Manual - Basic document on how php-gtk works, how to tranlate C gtk invokations to php and what classes / methods are supported with links to the actual GTK docs. Advanced HOWTO - As the project develops, we should problem included some reasonablely advanced applications, with commentary, on how to do the fancy stuff like color palettes, sortable lists, advanced editing, tree lists, etc. - Should probably include some advanced database stuff here, like updating multi table views with a 1:N relationship, generating and presenting reports, graphing data on the fly, etc. Thats about all I can think of a the moment, except we should beg, borrow and steal -- with appropriate credit of course -- from other similar projects wherever possible. -- Andrew Lawrence Smoke & Mirrors http://www.smoke-and-mirrors.net Tel: 416 461-8708 Fax: 416 461-1758