If something like this has already been suggested, please point me at the
earlier discussion.
I've read the Web2py manual (and bought three of them) since v1, and the
quality of both web2py and the manual has improved hugely.
To my mind, however, the manual tries to fulfil two roles currently: it is
a "howto" manual with lots of developed examples, and it is a reference
manual. I think the two functions should be split to two documents.
Rationale: the current format requires that the reference material be
spread throughout the book. A simple example: look up the 'URL' helper
function. The helper functions are listed in "Views" chapter, and indeed
the URL function is included in the list under "HTML helpers". However, it
is actually defined in the previous chapter ("Core"). The tutorial nature
of the manual requires it be discussed in core, but the reference nature
of the manual suggests it should be under HTML helpers.
This isn't the only example. It also isn't a criticism: as a single
document, the manual is about as good as it could be. My question is
simply: is it time to split it up?
--
"You can have everything in life you want if you help enough other people
get what they want" - Zig Ziglar.
Who did you help today?
