Good point. Not split it up but we need a second more introductory, manual.
massimo
On Sunday, 25 March 2012 12:00:44 UTC-5, backseat wrote:
>
> 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?
>
>
