You can send pull requests to the book repo: https://github.com/mdipierro/web2py-book
If you want to suggest substantial changes to the organization/structure of the docs, you might first open a discussion on the developers group: https://groups.google.com/forum/#!forum/web2py-developers Anthony On Tuesday, January 12, 2016 at 7:30:27 PM UTC-5, Alfonso Serra wrote: > > Ive spent 6 hours wondering why i couldnt update or insert a record with > the interactive console. > > After changing mysql user passwords, drop tables, remigrate everything, > mounting a fresh new web2py installation, tried to disable caching, i wasnt > able to update or insert a record even tho the docs says you have to type > row.update_record() after a single change, or db.mytable.insert(field1=...) > > its not until i read the commit section when i realised my mistake. > "In the interactive console you have to use db.commit()!", not the models, > not the controllers, not the views. > > The point is that i was trying to update or insert (with the console), > while in the docs didnt mention anything about this case, in the update, > insert sections. > > There are many other similar things like this that has happened to me, and > probably to many people. Most of them has been solved in this forum by the > developers but improving the docs may help many of us without having to > bother you guys that much. > > I know documenting is not nearly as fun as developing but i would love to > contribute to it as im learning and facing all these problems. > > So yes, the question is. How can we help to improve the docs? > > Would it be room for a wiki or is too much trouble? > > Thanks > > BTW: ive noticed a side effect by trying to insert a record at the console > without invoking commit. The table auto increment gets incremented > althought the record isnt inserted. > web2py 2.12.3 > mysql 5.5.24 > -- Resources: - http://web2py.com - http://web2py.com/book (Documentation) - http://github.com/web2py/web2py (Source code) - https://code.google.com/p/web2py/issues/list (Report Issues) --- You received this message because you are subscribed to the Google Groups "web2py-users" group. To unsubscribe from this group and stop receiving emails from it, send an email to [email protected]. For more options, visit https://groups.google.com/d/optout.
