On Sun, 2006-12-11 at 02:29 -0500, Karl Guertin wrote:
> After two months worth of comments, I've rewritten the 20 minute wiki 
> tutorial.
> 
> http://docs.turbogears.org/1.0/Wiki20/Page1
> 
> The primary enhancement is that I've added contextual lines in the
> examples, which will hopefully reduce the confusion over where to
> insert stuff.

It is much better now, very good job! Some thoughts from looking over
it:

- the old comments are still there, which are now out of sync with the
doc, so they should be trimmed/deleted
- the database still uses unicode, so the code as is will fail on mysql
( or does for me ). I think it would be better to change those to plain
strings so that it will work out of the box on other RDBMS
- perhaps a demo of the tg-admin sql sql command would be good before
the sql create, that helped me understand what was going on when I was
first exposed to object-relational mappers
- maybe a link to or example of exactly how one makes the database and
dev.cfg edit would be useful for beginners. i can write that up for
mysql if you'd like
- could the command prompts have a fully path name before them or
something to help people know which dir they should be in for issuing
commands?
- the use of std.url produces a warning from CherryPy about it being
deprecated

Thanks for all the work you put into that Karl. 
Iain


--~--~---------~--~----~------------~-------~--~----~
 You received this message because you are subscribed to the Google Groups 
"TurboGears" group.
To post to this group, send email to [email protected]
To unsubscribe from this group, send email to [EMAIL PROTECTED]
For more options, visit this group at 
http://groups.google.com/group/turbogears?hl=en
-~----------~----~----~----~------~----~------~--~---

Reply via email to