[webpy] web.py documentation

[Berwyn Hoyt]

As Angelo and Aaron both mentioned (see below), web.py could do with better docs.  But I just don't see it happening without some fan support. I'm thinking of creating a microPledge project to raise money to create the docs like they raised $17,000 for Ruby on Rails by merely accepting donations (though I don't imagine that we'll make it that high because Ruby has a much bigger following).  I know that using a new microPledge feature you can now "pledge now, and pay later" to get an indication of the level support "out there", but I'd like to open this for discussion here before I even start the project. As for who would do the documentation, we at microPledge would be willing to do it as a job, and you can assess the quality of our docs.  But we'd be happy if others quoted the job, too.  After all, the object is to make the docs, not the money. What do you think? - Berwyn Documentation & webpy.org As for Guido's initial grade of "F" for documentation.. How far have we come since then? Are we at least passing by now? Sadly, I think not.. Where's `teh communicator`? Is it in progress through Google's Summer of Code? Where do we stand with the other ideas? As for the core documentation, where does that stand? As for Resig's "one programmer using his own framework", how can we deny his statement short of proof? Can the following list be expanded? Can openlibrary.org be pushed to this list? In my opinion Micropledge's "fitting in" with the minimalist approach may be a potential turn off as people generally desire freedom rather than constraint. Who uses web.py? reddit.com, one of the top 1000 sites according to Alexa, uses web.py to serve its millions of daily page views. "It's the anti-framework framework. web.py doesn't get in your way," explains founder Steve Huffman. (Disclosure: web.py creator Aaron Swartz was also a founder of reddit.) colr.org, a color scheme picking site, is built in web.py. Yandex, a Russian traffic provider whose homepage alone receives 70 million daily page views, uses web.py for certain projects. LShift has used web.py to build websites for Expro and publisher Dorling Kindersley. "web.py allows us to do what we do best," they report. "It does the webapp thing brilliantly, and without requiring us to compromise on flexibility and originality." micropledge, a web app that collects funding for software ideas, is built in web.py. "We've enjoyed fitting in with its minimalist approach," says developer Ben Hoyt. Aaron, might you help me retrieve my account password for the newly implemented wiki? Username: angelogladding. I don't remember registering @ webpy.org but I did have an account previously with infogami.com. Any help would be appreciated. What do we, the web.py community, have to do to boost our reputation in the overall Python web community? I believe something close to `the communicator` as well as more accessible documentation (easier to browse and edit) will be a good start. Furthermore, I believe we need to describe the benefits of this "anti-framework" while comparing and contrasting other current solutions. We should also push for work on the "infrastructure" improvements listed on the ideas page as well. Essentially they are modules, components, plugins, whatever you want to call them. These seem to be the backbone of other successful frameworks. Seeing as openlibrary.org is an open project built on web.py, is there any code that can be offered from it to the greater community? Anyone else agree, disagree, have any comments or ideas? I look forward to rallied support for taking web.py to the next level. On 8/23/07, Tzury <[EMAIL PROTECTED]> wrote: What I didn't like was a comment of Resig reffer to web.py as one programmer using his own framework. That is a minimizing action for "great framework for those who hates framework" [EMAIL PROTECTED] http://angelogladding.com (626) 755 - 1417 --~--~---------~--~----~------------~-------~--~----~ You received this message because you are subscribed to the Google Groups "web.py" group. To post to this group, send email to webpy@googlegroups.com To unsubscribe from this group, send email to [EMAIL PROTECTED] For more options, visit this group at http://groups.google.com/group/webpy?hl=en -~----------~----~----~----~------~----~------~--~---