diff --git a/README.md b/README.md
new file mode 120000
index 0000000..4ef7694
--- /dev/null
+++ b/README.md
@@ -0,0 +1 @@
+doc/source/specification.rst
\ No newline at end of file
diff --git a/doc/source/configuration.rst b/doc/source/configuration.rst
index 42ceae8..1a50982 100644
--- a/doc/source/configuration.rst
+++ b/doc/source/configuration.rst
@@ -3,7 +3,7 @@ Configuration
 =============
 
 There is default configuration file ``config.yaml``, which is used by the scripts by default.
-If you wish to keep several configuration files, that is possible - just copy it and explicitly provide the name of it once you launch a script (``--config`` option) (not yet implemented in ``getlogs.py``).
+If you wish to keep several configuration files, that is possible - just copy it and explicitly provide the name of it once you launch a script (``--config`` option).
 
 Here is the description of available parameters in configuration file:
 
@@ -14,11 +14,7 @@ Here is the description of available parameters in configuration file:
 
 * **fuelip** the IP address of the master node in the environment
 * **rqdir** the path of *rqdir*, the directory containing info about commands to execute and logs to gather
-* **logdir** the path of directory for storing logs
 * **out-dir** directory to store output data
 * **timeout** timeout for SSH commands in seconds
-* **find** parameters of *find*
-
- * **template** template of parameters to pass to *find* when searching for logs
 
 Once you are done with the configuration, you might want to familiarize yourself with :doc:`Usage </usage>`.
diff --git a/doc/source/specification.rst b/doc/source/specification.rst
new file mode 100644
index 0000000..9b0cffc
--- /dev/null
+++ b/doc/source/specification.rst
@@ -0,0 +1,13 @@
+=======
+Specification
+=======
+
+* This tool is based on https://etherpad.openstack.org/p/openstack-diagnostics
+* Should work fine on the following environments that were tested: 4.x, 5.x, 6.x, 7.0, 8.0
+* Operates non-destructively. Completely safe.
+* Can be launched not only on the master node, if the master node's IP is specified.
+* Parallel launch, only on the nodes that are 'online'.
+* Commands (from ./cmds directory) are separated by roles (detected automatically) by the symlinks. So the command list may depend on release, roles and OS, there also can be commands that run everywhere. Also there are commands that are executed *only on one node* by its *role*, first encountered.
+* Human-readable format output of 'fuel node list'
+* Modular: possible to create a special package that contains only some required commands.
+* some archives are being created - *general* and *logs-**