On Jul 27, 2010, at 9:03 AM, mdipierro wrote: > For example?
Forms & Validators is pretty long. I could see breaking out CRUD. Right now that's not too much, but I'm hoping that the CRUD section will grow. Perhaps Validators could be its own chapter, leaving just a top-level overview in the Forms chapter explaining how validators relate to forms, but not describing each validator in detail. That reminds me of an old suggestion: that the manual have reference chapters or appendixes. So there'd be an appendix on validators, with a table of the details. One on fields. One on widgets. Then the main body chapters would have tutorial and generic material, but not the detailed reference. This solves two problem. 1) it makes the main chapters a little shorter, and 2) it makes the reference material easier to find, which would be handy for day-to-day programming. > > On Jul 27, 10:20 am, Jonathan Lundell <jlund...@pobox.com> wrote: >> On Jul 27, 2010, at 4:51 AM, mdipierro wrote: >> >>> web2py.com/book was broken into section >>> web2py.com/book2 is broken into chapters >> >>> what is better? >>> Once printed it will be the same. >> >> Offhand I'd say chapters, so I can use my browser-native search more >> effectively. >> >> In that case, it might be that some existing chapters that treat more than >> one subject could be split.
