[Couchdb Wiki] Update of "Documentation" by kxepal

[Apache Wiki <wi...@apache.org>]

Dear Wiki user,

You have subscribed to a wiki page or wiki category on "Couchdb Wiki" for change notification.

The "Documentation" page has been changed by kxepal:
http://wiki.apache.org/couchdb/Documentation?action=diff&rev1=19&rev2=20

Comment:
Add comment-answer for Noah Slater question about virtualenv.

  
  ''Can someone explain why a virtual environment is needed? Why can't, or shouldn't, I just install these packages normally? ~ Noah S.''
  
+ ''Virtualenv is good common practice to not mix system wide installed Python packages with project required ones. While in most cases you will not face any problems with installing sphinx and all his dependencies system wide, there are some edge cases that could make things broken:
+ 
+ - Your system package manager doesn't have sphinx or some of his depended package available to install. Manual system wide installation is like `make && make install` - one more step closer to unmanaged system;
+ 
+ - You already has sphinx installed, but of version that has breaking changes against required one, and you're needed this different version - updating could break something for you;
+ 
+ Since Python 3.3 release there wouldn't be any requirement for virtualenv since it goes to be in [[http://docs.python.org/dev/library/venv.html#module-venv|stdlib]] and sphinx is ready for Python 3.x. ~ Alexander Sh.
+ ''
+ 
  == Generation via Makefile ==
  
  There is no makefile support yet. It should do the following: