# HG changeset patch
# User Marcin Kuzminski <marcin@python-works.com>
# Date 2011-02-11 00:21:16
# Node ID bbd499c7b55eb4f3698c024531e99d692e25397e
# Parent  22c147726ea6a3ef5c9f1d6511af73d849d772a5

docs update

diff --git a/docs/index.rst b/docs/index.rst
--- a/docs/index.rst
+++ b/docs/index.rst
@@ -19,8 +19,9 @@ Documentation
 .. toctree::
    :maxdepth: 1
 
-   enable_git
-   statistics
+   usage/general
+   usage/enable_git
+   usage/statistics
    
 **Develop**
 
diff --git a/docs/enable_git.rst b/docs/usage/enable_git.rst
rename from docs/enable_git.rst
rename to docs/usage/enable_git.rst
diff --git a/docs/usage/general.rst b/docs/usage/general.rst
new file mode 100644
--- /dev/null
+++ b/docs/usage/general.rst
@@ -0,0 +1,54 @@
+.. _general:
+
+General RhodeCode usage
+=======================
+
+
+Repository deleting
++++++++++++++++++++
+
+Currently when admin/owner deletes a repository, RhodeCode does not physically
+delete a repository from filesystem, it renames it in a special way so it's
+not possible to push,clone or access repository. It's worth a notice that,
+even if someone will be given administrative access to RhodeCode and will 
+delete a repository You can easy restore such action by restoring `rm__<date>`
+from the repository name, and internal repository storage (.hg/.git)
+
+Follow current branch in file view
+++++++++++++++++++++++++++++++++++
+
+In file view when this checkbox is checked the << and >> arrows will jump
+to changesets withing the same branch currently viewing. So for example
+if someone is viewing files at 'beta' branch and marks `follow current branch`
+checkbox the << and >> buttons will only show him revisions for 'beta' branch
+
+
+Compare view from changelog
++++++++++++++++++++++++++++
+
+Checkboxes in compare view allow users to view combined compare view. You can
+only show the range between the first and last checkbox (no cherry pick).
+Clicking more than one checkbox will activate a link in top saying
+`Show selected changes <from-rev> -> <to-rev>` clicking this will bring
+compare view
+
+Compare view is also available from the journal on pushes having more than
+one changeset
+
+
+
+Mailing
++++++++
+
+When administrator will fill up the mailing settings in .ini files
+RhodeCode will send mails on user registration, or when RhodeCode errors occur
+on errors the mails will have a detailed traceback of error.
+
+
+Trending source files
++++++++++++++++++++++
+
+Trending source files are calculated based on pre defined dict of known
+types and extensions. If You miss some extension or Would like to scan some
+custom files it's possible to add new types in `LANGUAGES_EXTENSIONS_MAP` dict
+located in `/rhodecode/lib/celerylib/tasks.py`
\ No newline at end of file
diff --git a/docs/statistics.rst b/docs/usage/statistics.rst
rename from docs/statistics.rst
rename to docs/usage/statistics.rst