This issue comes up very often. Currently we have: web2py.com/AlterEgo wiki.web2py.com web2pyslices.com
In the past people have volunteered to setup moimoin and trac. I always agreed to link a new resource to the main web page. I do not think this is a technological problem. I think there is not enough motivation because the book is there. Moreover the online documentation is very hard to maintain because code changes. For me the easiest solution it just to revise the book once/year and distribute new chapters (or edited chapters) for free when ready. Personally, I could use help in fixing the docstrings and unittests so that documentation would be automatically generated using Sphinx. This is the only way to have docs that always up to date. You can use ANY text from the book to improve docstrings. Massimo On Feb 1, 6:07 pm, tiago almeida <tiago.b.alme...@gmail.com> wrote: > Thanks for replying. > > I bought the book and I agree, it's great. But what I'm asking is some help > from the community to start an official "wiki", because the one that exists > is not openly editable, or at least, make it openly editable > > What would be great for the web2py project (and its users) is if some site > existed where one could go and get access to things like: > - Announcements/News > - change log ( what was introduced in which version and respective > implications, if any ) > - usage examples > - recipes (web2pyslices seems to fill this role quite well) > - plugin list > - Howto's > - FAQs > - up-to-date deployment guides > - Forum to discuss future features (?) > - etc.. > > I know many of these things are available either on the mailing list, the > book or web2py.com but they are hard to find ( mailing list search is > completely broken! ) > > Also, I believe it has to be community editable because it is just too much > work to be done by the authors of the code since they are busy working on > the next features and bug fixes (as they should be!). > > What do you think? Is it a problem of getting hosts, domains or just > inertia/lack of interest? > > See ya. > -- > Tiago > > On Mon, Feb 1, 2010 at 9:53 PM, Christopher Steel > <chris.st...@gmail.com>wrote: > > > Hi Tiago, > > > Your right, things are a bit scattered around. That was one of my > > first observations as well. That said a wealth of documentation can be > > found, but it is "scattered". The following list of resources that > > gets updated fairly regularly (a big Thank You Denesl!) should get you > > started. > > > Go tohttp://groups.google.com/group/web2pythen choose "web2py help > > & resources" > > > The Web2py manual (second edition) is an excellent and well organized > > resource as well ($12.00 on Lulu) and well worth the 12 dollars... > > > Welcome > > > Chris > > > On Feb 1, 7:45 am, tiago almeida <tiago.b.alme...@gmail.com> wrote: > > > Hello all, > > > > I really like web2py but allow me to say that the documentation in > > general > > > is a bit lacking. > > > For instance, the wiki looks to be unmantained for a long time. Also, I > > > don't see a way to create pages there. > > > > As someone pointed out a few days ago, having only the pdf as a > > > documentation source is not enough. > > > > My question is: *Why is the wiki @http://wiki.web2py.comdead?*I'd be > > > happy to contribute a few time writing documentation but I don't see how > > > (apart from starting another wiki which doesn't make much sense when > > there > > > is one already). > > > > To someone starting with web2py (like me), having the documentation > > > scattered all over the web is a bit hard (only today found out about > > > local_import, ironically with a mail from someone pointing to the same > > > problem; i have no idea what T3/t4 are (apart from seeing them > > somewhere), > > > etc). > > > > Is it possible to at least resuscitate the wiki so that it can be used as > > a > > > de facto wiki with examples and change history etc? > > > > Best regards, > > > Tiago Almeida > > > -- > > You received this message because you are subscribed to the Google Groups > > "web2py-users" group. > > To post to this group, send email to web...@googlegroups.com. > > To unsubscribe from this group, send email to > > web2py+unsubscr...@googlegroups.com<web2py%2bunsubscr...@googlegroups.com> > > . > > For more options, visit this group at > >http://groups.google.com/group/web2py?hl=en. > > -- You received this message because you are subscribed to the Google Groups "web2py-users" group. To post to this group, send email to web...@googlegroups.com. To unsubscribe from this group, send email to web2py+unsubscr...@googlegroups.com. For more options, visit this group at http://groups.google.com/group/web2py?hl=en.
