docs updates on git support

docs/index.rst

@@ -20,7 +20,7 b' Users Guide'
    :maxdepth: 1
 
    usage/general
-   usage/enable_git
+   usage/git_support
    usage/statistics
    usage/backup
    

docs/usage/git_support.rst

@@ -1,13 +1,35 b''
-.. _enable_git:
+.. _git_support:
 
-Enabling GIT support (beta)
-===========================
+GIT support
+===========
 
 
-Git support in RhodeCode 1.1 was disabled due to current instability issues. 
-However,if you would like to test git support please feel free to re-enable it. 
-To re-enable GIT support just uncomment the git line in the 
-file **rhodecode/__init__.py**
+Git support in RhodeCode 1.3 was enabled by default. 
+Although There are some limitations on git usage.
+
+- No hooks are runned for git push/pull actions.
+- logs in action journals don't have git operations
+- large pushes needs http server with chunked encoding support.
+ 
+if you plan to use git you need to run RhodeCode with some
+http server that supports chunked encoding which git http protocol uses, 
+i recommend using waitress_ or gunicorn_ (linux only) for `paste` wsgi app 
+replacement.
+
+To use waitress simply change::
+
+    use = egg:Paste#main
+
+To::
+    
+    use = egg:waitress#main
+
+In you .ini file, then you can simply run `paster serve` as usual.
+
+
+  
+You can always disable git/hg support by editing a 
+file **rhodecode/__init__.py** and commenting out backends
 
 .. code-block:: python
  
@@ -16,9 +38,5 b' file **rhodecode/__init__.py**'
        #'git': 'Git repository',
    }
 
-.. note::
-   Please note that the git support provided by RhodeCode is not yet fully
-   stable and RhodeCode might crash while using git repositories. (That is why
-   it is currently disabled.) Thus be careful about enabling git support, and
-   certainly don't use it in a production setting!
-   
  No newline at end of file
+.. _waitress: http://pypi.python.org/pypi/waitress
+.. _gunicorn: http://pypi.python.org/pypi/gunicorn
  No newline at end of file