Are you aware of mercurial online book howto (http://hgbook.red-bean.com/)
??

I don't remember exactly how it works, but the online book is under version
control and example were updating with version of mercurial or something
like this...

Maybe we could get good idea from there to improve doc process of web2py?

Richard

On Fri, Nov 19, 2010 at 9:07 AM, GoldenTiger <[email protected]> wrote:

> Ok, i checked it, you found very hard to see errata :)  i think there
> is enough to start editing, following lines shows suggestion/errata i
> checked and accepted
>
> SUGGESTION #1  Undocumented IS_IN_SET
> http://groups.google.com/group/web2py/browse_frm/thread/418417e058ef9428
>
> You can use dictionary to define values e.g.
>
> Field('name',requires=IS_IN_SET({'key1':'label1','key2':'label2','key3':'label3'}))
>
> -------------------------------------------------------------------
>
> SUGGESTION #2  Errata --> UNFIXED
> URL
> http://web2py.com/book/default/chapter/02?search=function+that+checks+whether+its+argument+is+prime
> PAGE    ERROR                 SUGGESTED FIX
> p 72    if number % p:        if (number % p) == 0:
>
> >>> def isprime(number):
> ...     for p in range(2, number):
> ...         if number % p:
> ...             return False
> ...     return True
> ...
> >>> isprime(3)
> False
> ------------------------------------------------------------
>
> SUGGESTION #3  Errata ---> OK, BETTER IF EXPLICIT
>
> PAGE    ERROR                 SUGGESTED FIX             Notes
> p 73    seconds)        add line: >>> seconds = 60      seconds not defined
>
> SUGGESTION #4
>
> PAGE    ERROR                 SUGGESTED FIX             Notes
> p 85    After you press [submit]        After you press [create]
>
> http://web2py.com/book/default/chapter/03?search=You+can+create+a+new+application+simply+by+typing+its+name+in+the+form
> ---------------------------------------------------------
>
> SUGGESTION #5   ->
>
> PAGE    ERROR                                           SUGGESTED
> FIX
> p 85    Picture shows "Installed applications" screen   add caption;
> describe how to get to this screen OR remove this section and just
> start at the "EDIT" page description
>
> SUGGESTION #6
> PAGE    ERROR                                           SUGGESTED
> FIX
> p 86    the order of the categories does not match actual UI    swap
> "modules" and "static files," add "plugins"
>
> SUGGESTION #7  --> Not very important, but it's errata
> p 89    Hello form MyApp        Hello from MyApp        typo in screen
> capture
> http://web2py.com/book/static/book_images_png/hello_myapp4.png
>
>
> ....
>
> I continue offline

Reply via email to