Berwyn Hoyt wrote: > 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 <http://micropledge.com> project to > raise > money to create the docs like they raised $17,000 for Ruby on Rails > <http://www.pledgie.com/campaigns/34> 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 > <http://micropledge.com/help>. 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 <http://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 <http://webpy.org/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 <http://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 <http://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 <http://colr.org/>, a color scheme picking site, is built in >> web.py. >> >> Yandex <http://yandex.ru/>, a Russian traffic provider whose homepage >> alone receives 70 million daily page views, uses web.py for certain >> projects. >> >> LShift <http://www.lshift.net/> has used web.py to build websites for >> Expro <http://exproretail.com/> and publisher Dorling Kindersley >> <http://travel.dk.com/>. "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 <http://micropledge.com/>, 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 <http://webpy.org> but I did have an account previously with >> infogami.com <http://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 <http://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] <mailto:[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 >>
Maybe it is just me, but I too often thought of working on the webpy docs a little bit. When I look something up online and see it is not there or explained in a way that is hard to understand for inexperienced people, I often thought "alright lemme fix that small part". This is where I have to be honest; I really just can not be arsed to log in. I know it sounds stupid, but this feeling of "let's fix that" always comes in a whim and whenever I have to think hard to remember my password I already feel like it's been too much trouble to begin with. I wonder if maybe it is possible to allow anonymous edits to the documentation, maybe with a captcha? Really, I know it is conceited and stupid and that I should just take the time to remember my password once and log in. If it were just me, I wouldn't even mention it. Though, I can not help but think that maybe other people feel the same way. Many times have I seen a wiki project I wanted to work on a little bit, but subsequently dropped the thought because it required you to register for it. Am I the only one? Alright, that's my arrogant 2 cents, I hope it does not sound too annoying :) Greetings, b^4 --~--~---------~--~----~------------~-------~--~----~ You received this message because you are subscribed to the Google Groups "web.py" group. To post to this group, send email to [email protected] 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 -~----------~----~----~----~------~----~------~--~---
