diff --git a/README.md b/README.md
deleted file mode 100644
index 4e220cb..0000000
--- a/README.md
+++ /dev/null
@@ -1,15 +0,0 @@
-fuel-createmirror
-=================
-
-Script for partial deb repositories mirroring with sanity check.
-
-# Description
-
-WARNING: This set of scripts is not designed to be used on 'live' repositories
-that are available to clients during synchronization, because it violates
-common synchronization order (packages first, metadata later) to provide
-partial mirroring capability. It means that repositories will be
-inconsistent during the update. Please use these scripts in conjunction
-with snapshots, on inactive repos, etc.
-
-Only rsync mirrors are supported.
\ No newline at end of file
diff --git a/README.rst b/README.rst
index 17ec5fb..6608033 100644
--- a/README.rst
+++ b/README.rst
@@ -1,17 +1,39 @@
-=========
-Packetary
-=========
+====================
+Repository structure
+====================
 
-The chain of tools to manage package`s lifecycle.
+* contrib/fuel_mirror
+  It is a command line utility that provides the same functionality
+  and user interface as deprecated fuel-createmirror. It provides
+  two major features:
+  * clone/build mirror (full or partial)
+  * update repository configuration in nailgun
+  First one is a matter of packetary while second one should be left
+  totally up to fuelclient. So this module is to be deprecated soon
+  in favor of packetary and fuelclient.
 
-* Free software: Apache license
-* Documentation: http://docs.openstack.org/developer/fuel-mirror
-* Source: http://git.openstack.org/cgit/openstack/fuel-mirror
-* Bugs: http://bugs.launchpad.net/fuel
+  WARNING: It is not designed to be used on 'live' repositories
+  that are available to clients during synchronization. That means
+  repositories will be inconsistent during the update. Please use these
+  scripts in conjunction with snapshots, on inactive repos, etc.
 
-Features
---------
+* debian
+  Specs for DEB packages.
 
-* Common interface for different package-managers.
-* Utility to build dependency graph for package(s).
-* Utility to create mirror of repository according to dependency graph.
+* doc
+  Documentation for packetary module.
+
+* packetary
+  It is a Python library and command line utilty that allows
+  one to clone and build rpm/deb repositories.
+  Features:
+  * Common interface for different package-managers.
+  * Utility to build dependency graph for package(s).
+  * Utility to create mirror of repository according to dependency graph.
+
+* perestroika
+  It is a set shell/python script that are used to build DEB/RPM
+  packages. These scripts are widely used by Fuel Packaging CI.
+
+* specs
+  Specs for RPM packages.