diff --git a/docs/index.txt b/docs/index.rst
copy from docs/index.txt
copy to docs/index.rst
--- a/docs/index.txt
+++ b/docs/index.rst
@@ -1,19 +1,82 @@
-rhodecode
-++++++++++
+.. _index:
+
+Welcome to RhodeCode (RhodiumCode) documentation!
+=================================================
+
+``RhodeCode`` is Pylons based repository management and serving for mercurial. 
+It's similar to github or bitbucket, but focuses more on closed access restrictions.
+There's no default free access to RhodeCode You have to create an account in order
+to use the application. 
+
+
+RhodeCode uses `Semantic Versioning <http://semver.org/>`_
+
+**Features**
 
-This is the main index page of your documentation. It should be written in
-`reStructuredText format <http://docutils.sourceforge.net/rst.html>`_.
+- Has it's own middleware to handle mercurial protocol request. Each request can 
+  be logged and authenticated. Runs on threads unlikely to hgweb You can make
+  multiple pulls/pushes simultaneous
+- Full permissions and authentication per project private/read/write/admin. 
+  One account for web interface and mercurial push/pull/clone.
+- Mako templates let's you customize look and feel of application.
+- Beautiful diffs, annotations and source codes all colored by pygments.
+- Mercurial branch graph and yui-flot powered graphs with zooming and statistics
+- Admin interface with user/permission management. User activity journal logs
+  pulls, pushes, forks,registrations. Possible to disable built in hooks
+- Server side forks, it's possible to fork a project and hack it free without
+  breaking the main.   
+- Full text search on source codes, search on file names. All powered by whoosh
+  and build in indexing daemons
+  (no external search servers required all in one application)
+- Rss / atom feeds, gravatar support, download sources as zip/tarballs  
+- Async tasks for speed and performance using celery (works without them too)  
+- Backup scripts can do backup of whole app and send it over scp to desired 
+  location
+- Setup project descriptions and info inside built in db for easy, non 
+  file-system operations
+- Added cache with invalidation on push/repo management for high performance and
+  always up to date data. 
+- Based on pylons 1.0 / sqlalchemy 0.6 / sqlite
 
-You can generate your documentation in HTML format by running this command::
-
-    setup.py pudge
 
-For this to work you will need to download and install `buildutils`_,
-`pudge`_, and `pygments`_.  The ``pudge`` command is disabled by
-default; to ativate it in your project, run::
+.. figure::  images/screenshot1_main_page.png
+   :align:   left
+
+   Main page of RhodeCode
+
+.. figure::  images/screenshot2_summary_page.png
+   :align:   left
+
+   Summary page
+
+
+**Incoming**
+
+- code review based on hg-review (when it's stable)
+- git support (when vcs can handle it - almost there !)
+- commit based wikis
+- clonning from remote repositories into rhodecode (git/mercurial)
+- other cools stuff that i can figure out (or You can help me figure out)
 
-    setup.py addcommand -p buildutils.pudge_command
+Documentation
+=============
+
+**Installation:**
+
+.. toctree::
+   :maxdepth: 1
+
+   installation
+   setup
 
-.. _buildutils: http://pypi.python.org/pypi/buildutils
-.. _pudge: http://pudge.lesscode.org/
-.. _pygments: http://pygments.org/
+Other topics
+============
+
+* :ref:`genindex`
+* :ref:`search`
+
+.. _python: http://www.python.org/
+.. _django: http://www.djangoproject.com/
+.. _mercurial: http://mercurial.selenic.com/
+.. _subversion: http://subversion.tigris.org/
+.. _git: http://git-scm.com/
\ No newline at end of file