TG2 beta docs run-through issues ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ TG2 General: ~~~~~~~~~~~~~
1) Really need an updated version of the TG "flowchart" image that shows how the various components fit together. (Perhaps reformatted to more clearly show the request life-cycle, with TG, Pylons, and Paste clearly delineated.) Although it's not very clear, see: http://dev.catalyst.perl.org/attachment/wiki/WikiStart/catalyst-flow.png 2) Quickstart generated code needs more detailed in-code documentation. This is greatly needed to get new users up to speed.. 3) What is the TG2 "API"?... other than @expose and returning the dict () from a controller, how can/should I interact with the TurgoGears stack from my code? 4) Need a TG2 specific tutorial that covers basic genshi template building "from scratch". Those coming from a ASP/PHP background will be very lost when trying to look at the quickstart'ed template files. TG2 Install: ~~~~~~~~~~~~ 1) Need an introduction "what we will do" summery for three common use cases. (Win/Mac/Ubuntu) 2) Why upgrade warning for virtualenv install? It's certainly a new install, as this is a tutorial. (Perhaps re-word.) 3) When installing pysqlite, the user must have the sqlite3 dev files installed, as well. (sqlite3-dev package on Ubuntu) 4) Suggest, as an option, ipython. Since paster shell can use it. 5) The "Installing the development version of Turbogears 2" section should have a paragraph, besides just a link. 6) Should have a closing paragraph with links to "quickstart" and "Wiki20" tutorials. TG2 Quick Start tutorial: ~~~~~~~~~~~~~~~~~~~~ 1) User is forced to make a choice about authorization during Quickstart setup, but this is not mentioned in tutorial text. 2) Explain why "paster setup-app" is needed. (Seems to work with out it?) Why is it written "if it's the first time running the app", certainly it's the first run! This is a tutorial. :) 3) This should be expanded with a "part 2" into a "hello world" style tutorial that actually has the user modifying some code. As it used to be in early (error ridden) versions of the docs. --~--~---------~--~----~------------~-------~--~----~ 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 -~----------~----~----~----~------~----~------~--~---
