Hi Anita, On Feb 22, 6:16 am, anita kean <[email protected]> wrote: > I just sent this message to the turbogears mailing list > by mistake instead of here. Sorry! > Here it goes again: > > 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
This is probably because these tutorials were created *after* virtualenv became the recommended installation method for tg2. But I agree with you that we need to be consistent across all the docs. regards Sanjiv > > 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. > > -- > Anita --~--~---------~--~----~------------~-------~--~----~ You received this message because you are subscribed to the Google Groups "TurboGears Docs" 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-docs?hl=en -~----------~----~----~----~------~----~------~--~---
