On Sat, Feb 21, 2009 at 7:10 PM, anita kean <[email protected]> wrote: > > Hello folks > > There's a sort of inconsistency among the docs tutorials about > whether or not work is done in a virtual environment. > > The "How to install TurboGears2" document (DownloadInstall) > includes the item "Setting up a Virtual Environment", not listed as > optional, and illustrates the "(tg2env)$" prompt as a sign that the > virtualenv having been activated. > > Then (till I changed it) proceeded to illustrate shell commands > with a regular prompt. - > > The next section, Quickstarting a TG2 project, > made no reference to a virtualenv - so last week I inserted > a statement at the top that if tg2 had been installed in a > virtual env, it was assumed it had now been activated. > (and linked back to the process of activation). > > The wiki20 docs don't mention virtualenv, > or show any tg2env prefix on the prompt, but for example > the two tutorials in Extensions.Geo docs do - every shell > prompt there has the (tg2env) prefix. > > A recursive grep on the docs directories shows that the only > occurrence of the prefix is in: > * main/DownloadInstall.rst > * main/Extensions/Geo/TileCacheTutorial.rst > * main/Extensions/Geo/MapFishTutorial.rst > > I'm going through the wiki20 and toscawidgets tutorials > converting SA setup to declarative, and wondering > what the policy is: > - all tutorials explicitlly assume virtualenv? > - none do? > - it's up to the whim of the documentor? > > I'm happy to insert that prompt in the wiki20 and toscawidgets > tutorials if you want. >
My take on this is that the standard now is to use virtualenv. I also think that docs should show virtualenv setup as default. If somebody wants to use it without virtualenv then that person would not be a new/incoming user to tg2 but maybe somebody with prior experience who knows exactly what problems he/she is getting into. So I think if you could provide patch that shows a use of virtualenv as default then that would be perfect :) Thanks, Lucas --~--~---------~--~----~------------~-------~--~----~ 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 -~----------~----~----~----~------~----~------~--~---
