Maybe submit a Github issue in the book repo requesting this feature. Anthony
On Tuesday, September 16, 2014 6:12:06 PM UTC-4, Anthony wrote: > > Agreed, but for the most part, if something is truly lacking from the > documentation, it would be best if it could be included in the > documentation itself, rather than in a long list of unorganized comments at > the bottom of the page. You can always make a pull request on the book repo > (https://github.com/mdipierro/web2py-book) for direct changes to the > documentation. > > Allowing user comments/feedback isn't a bad idea, though, but we would > probably have to change the UI -- currently each chapter is a very long > HTML page, and putting comments at the bottom would in many cases place > them very far from the relevant context in the chapter. > > Note, the old version of the book did in fact allow comments at the bottom > of each page (though there was no upvote/downvote feature), but that > functionality was not migrated to the newer book app. > > Anthony > > On Tuesday, September 16, 2014 6:02:42 PM UTC-4, Robin Manoli wrote: >> >> It's not really what I'm looking for. There are many benefits to the php >> documentation way: >> 1. the comments are where you are looking for help >> 2. when you are looking for help, and find a solution of your own, you >> can post it where you were looking >> 3. the current documentation is unclear in many places, and it's not very >> efficient to browse around the form/slices/stackoverflow/examples to get to >> the solution, when it could already be there where you look first >> 4. the documentation could become verbose instead of lacking >> 5. there are many little tricks that i have read about in the forum that >> i couldn't find in the documentation... if all these tricks would be more >> accessible, web2py's many hidden features could be used more >> >> Den torsdagen den 11:e september 2014 kl. 00:27:10 UTC+2 skrev Anthony: >>> >>> It's not embedded with the main documentation, but for user contributed >>> content, we do have http://www.web2pyslices.com/home. >>> >>> Anthony >>> >>> On Wednesday, September 10, 2014 5:55:36 PM UTC-4, Robin Manoli wrote: >>>> >>>> Hey, >>>> the php documentation has user comments with examples of how to use >>>> different functions. This is a great complement to their documentation. >>>> >>>> With web2py I have stumbled upon many things in these forums that I >>>> have not seen in the documentation. I'm not sure how often you update it, >>>> since I keep finding new things there too. >>>> >>>> Still, don't you think it would be better if we all could contribute >>>> with common and examples to an api-type of documentation for web2py? I >>>> think the php documentation does this really well. >>>> >>> -- 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.
