diff --git a/docs/changelog.rst b/docs/changelog.rst
--- a/docs/changelog.rst
+++ b/docs/changelog.rst
@@ -3,13 +3,13 @@
 Changelog
 =========
 
-1.0.0 (**2010-10-xx**)
+1.0.0 (**2010-11-02**)
 ----------------------
 
 - security bugfix simplehg wasn't checking for permissions on commands
   other than pull or push.
 - fixed doubled messages after push or pull in admin journal
-- templating and css corrections, fixed repo switcher on chrome,updated titles
+- templating and css corrections, fixed repo switcher on chrome, updated titles
 - admin menu accessible from options menu on repository view
 - permissions cached queries
 
diff --git a/docs/index.rst b/docs/index.rst
--- a/docs/index.rst
+++ b/docs/index.rst
@@ -80,6 +80,8 @@ Incoming
 - commit based build in wiki system
 - clone points and cloning from remote repositories into rhodecode 
   (git_ and mercurial_)
+- more statistics and graph (global annotation + some more statistics)
+- user customized activity dashboards
 - some cache optimizations
 - other cools stuff that i can figure out (or You can help me figure out)
 
@@ -92,12 +94,11 @@ License
 Documentation
 -------------
 
-**Installation:**
-
 .. toctree::
    :maxdepth: 1
 
    installation
+   upgrade
    setup
    changelog
 
diff --git a/docs/upgrade.rst b/docs/upgrade.rst
new file mode 100644
--- /dev/null
+++ b/docs/upgrade.rst
@@ -0,0 +1,32 @@
+.. _upgrade:
+
+Upgrade
+=======
+
+Upgrade from Cheese Shop
+------------------------
+
+Easiest way to upgrade ``rhodecode`` is to run::
+
+ easy_install -U rhodecode
+
+Or::
+
+ pip install --upgrade rhodecode
+
+
+Then make sure You run from the installation directory
+
+::
+ 
+ paster make-config RhodeCode production.ini
+ 
+This will display any changes made from new version of RhodeCode To your
+current config. And tries to do an automerge.
+
+
+.. _virtualenv: http://pypi.python.org/pypi/virtualenv  
+.. _python: http://www.python.org/
+.. _mercurial: http://mercurial.selenic.com/
+.. _celery: http://celeryproject.org/
+.. _rabbitmq: http://www.rabbitmq.com/
\ No newline at end of file