I'm not trying to be clever but I suppose the answer depends on who your target audience is. One way of grouping the audience is:
1) people evaluating web frameworks and know nothing of web2py, 2) people who have read the web2py manual but no real experience of it, 3) people who know web2py already but are just using it, 4) hard-core web2py users who know it inside out? I have 1 weeks experience of both web2py and python. However, in that one week I have gone through a lot of web2py core code to try to understand the sequence of events and what each part does (and I have years of programing and developing webapps behind me). So, I put myself at about 2.5 and it just about makes sense to me. If I had just picked up the manual on day 1 without using web2py at all I'm pretty sure I would have been lost. I think it is interesting that "web2py" is mentioned only 5 times in the whole text (excluding the API description): once at the end of Low- level Patterns, 4 times at the end of High-level patterns and a one- off on page 19. Assuming a diverse audience, I think that the chapter/section structure could be clearer - maybe: 1.0 Introduction 2.0 Patterns: 2.1 Low-Level Patterns, 2.2 High-level Patterns 3.0 T2 - Introduction: 3.1 Web2py (first 5 references to web2py here plus expand to suit audience or refer to other docs), 3.2 T2 Concepts(?), 3.3 Simple Example (page 7 onwards), 3.4 More Complex Example 4.0 T2 - Technical: 4.1 Files in T2 (currently 0.5), 4.2 API (currently 0.6.1 to 0.6.3), 4.3 Database (currently page 23) 5.0 Examples (currently 0.6.4 to page 22) - ideally each subsection matched to a Pattern in 2.0 with some extras, e.g.Google Checkout Now I've just got to download t2 and try it out! Bill On Oct 16, 1:41 am, mdipierro <[EMAIL PROTECTED]> wrote: > thanks. Syntactics aside. Does the manual make sense? > > Massimo > > On Oct 15, 5:20 pm, Keith Edmunds <[EMAIL PROTECTED]> wrote: > > > Page 24: > > > created signature stores the name of the person created the > > record. > > > created --> creating (or "who created") > > ----------------- > > > db.mytable.myfield.comment is the comment to be shows > > in the third column of create/update forms. > > > shows --> shown > > ------------------ > > > db.mytable.exposes is a list of fields that should apper in > > > apper --> appear > > ------------------- > > > Keith --~--~---------~--~----~------------~-------~--~----~ You received this message because you are subscribed to the Google Groups "web2py Web Framework" group. To post to this group, send email to web2py@googlegroups.com To unsubscribe from this group, send email to [EMAIL PROTECTED] For more options, visit this group at http://groups.google.com/group/web2py?hl=en -~----------~----~----~----~------~----~------~--~---
