On 02:01 Fri 11 Mar , Olivier FAVRE-SIMON wrote: > > And I don't myself pretend to have *today* sufficient knowledge of > Webware to be at the lead of a major move. > > But then I must admit it is a vicious endless circle : > > No concrete example or tutorial for beginners, insufficient docs => > less people interested in Webware => less docs and tutorials because > the other people have learned the hard way (OK not so hard we all love > writing/reading python code) so they dont feel it necessary to write > docs...
While what you say is all quite true, this is the condition of many Python frameworks. I'm sure that most of us have landed on Webware because we thought it was worth the pain of having to dig through mailing list archives for the answers. It's an insane process. > Without the core developers / old warriors making the first move and > feeding the community with better docs, most of the > wanna-be-python-webware-hackers (like me today) will either stall at > their current knowledge level, each using it's own custom and unique > approach over and over again, or will resign and move to some more > user-friendly framework. These are all reasons why documentation is wanting. My projects have been driven by specific requirements, so I've been uneasy about documenting my custom methods, which may not be a pattern for best-practices, but work for what I need the framework to do. > Maybe the first steps could be : > - Have a site with "doc requests" like the feature requests often > found for development. > - A kind of Webware Wiki/devcenter where everyone could contribute, like > codeproject.com or codeguru.com We have a Wiki, so anyone who wants to start something new or audit existing material can do so. You're ideas are good, so I would encourage you to start a how-to section on the Wiki or something similar. Eric Radman ------------------------------------------------------- SF email is sponsored by - The IT Product Guide Read honest & candid reviews on hundreds of IT Products from real users. Discover which products truly live up to the hype. Start reading now. http://ads.osdn.com/?ad_id=6595&alloc_id=14396&op=click _______________________________________________ Webware-discuss mailing list Webware-discuss@lists.sourceforge.net https://lists.sourceforge.net/lists/listinfo/webware-discuss
