diff --git a/doc/architecture_model.rst b/doc/architecture_model.rst
index 1115d08..079e968 100644
--- a/doc/architecture_model.rst
+++ b/doc/architecture_model.rst
@@ -2,16 +2,20 @@
 ARCHITECTURE DATA MODEL
 =======================
 
---------
 Overview
 --------
 
-Architecture data model produced by Joker could be consumed by configuration
-validator tool (Dark Knight), by architecture graph (Stencil) and others. 
+We want to introduce unified data structure which contains all information
+necessary to inspect, analyze, describe and visualize OpenStack architecture.
 
-At some point it should be made convertible into format accepted by deployment
-systems (e.g. Fuel or TripleO) which will allow to effectively 'clone' OpenStack
-clouds using different deployment applications.
+This Architecture data model could be consumed and processed by configuration
+analysis and diagnostics tool (**Dark Knight**) and by architecture visualizer
+(**Stencil**). 
+
+Arhictecture data model must include all information necessary to deployment
+systems (e.g. **Fuel** or **TripleO**). We will implement simple conversion tools which
+will allow to configure these deployment systems and effectively support
+'portable' clouds.
 
 This model could be reused by Rally project to compare benchmarking results for
 different architectures.
@@ -24,11 +28,10 @@ support contract pricing purposes.
 The model could be used to perform automated/guided hardening of OpenStack
 architecture and configuration.
 
------------
 Data Format
 -----------
 
-This section proposes data model format which allows to describe any OpenStack
+This section proposes data model format which allows to describe an OpenStack
 installation. The model includes data regarding physical infrastructure, logical
 topology of services and mapping between the two.
 
diff --git a/doc/configuration_validator.rst b/doc/configuration_validator.rst
index c1208f3..f7a81ed 100644
--- a/doc/configuration_validator.rst
+++ b/doc/configuration_validator.rst
@@ -1,6 +1,12 @@
 OPENSTACK DIAGNOSTICS PROPOSAL
 ==============================
 
+Project Name
+------------
+
+**Official:** OpenStack Diagnostics
+**Codename:** Dark Knight
+
 Overview
 --------
 
@@ -40,7 +46,7 @@ TBD
 Scope
 -----
 
-As an MVP1, we create service that includes:
+As an MVP1, we create a service that includes:
 
 1. Rules engine with grammatic analysis capabilities
 1. Extensible implementation of rules