ripreal · ripreal · Feb 7, 2019 · Feb 2, 2019 · Feb 2, 2019 · Feb 2, 2019
diff --git a/README.md b/README.md
@@ -10,8 +10,8 @@
 
 - [Vanessa-ADD ( ADD )](#vanessa-add--add-)
     - [Введение](#введение)
-    - [Установка](#установка)
     - [Справка и полезные ссылки](#справка-и-полезные-ссылки)
+    - [Установка](#установка)
     - [Обсуждения, задачи, сообщения об ошибках](#обсуждения)
     - [Сравнение с другими инструментами](#сравнение-с-другими-инструментами)
     - [Помощь проекту](#how-to-help)
@@ -34,12 +34,24 @@ Vanessa-ADD is a set of testing tools for [1C:Enterprise 8 platform](http://v8.1
 
 Возможности:
 
++ готовые универсальные "дымовые тесты" различных видов
 + различные виды тестирования (модульного/юнит, приемочного, сценарного для 1С 8.3, интеграционного, TDD)
 + проверка поведения (BDD/Gherkin)
-+ формирование автодокументации в формате Markdown и видео.
++ формирование автодокументации в формате Html или Markdown или в виде видео-инструкций.
 
 Vanessa-ADD является наследником 2-х продуктов - [xUnitFor1C](https://github.com/xDrivenDevelopment/xUnitFor1C) и [Vanessa-Behavior](https://github.com/silverbulleters/vanessa-behavior). Совместимость с VB 1.Х и xUnitFor1C 4.Х гарантирована (за исключением функциональности циклов и условий в Vanessa Behavior)
 
+<a id="markdown-справка-и-полезные-ссылки" name="справка-и-полезные-ссылки"></a>
+## Справка и полезные ссылки
+
+Обязательно ознакомьтесь с:
+
++ **Документацией по продукту** [doc/README.md](./doc/README.md)
+
++ часто задаваемыми вопросами [FAQ.md](./F.A.Q.MD)
++ руководством контрибьютора [CONTRIBUTING.md](./.github/CONTRIBUTING.md)
++ известными проблемами [KNOWN-PROBLEMS.md](./doc/KNOWN-PROBLEMS.md)
+
 <a id="markdown-установка" name="установка"></a>
 ## Установка
 
@@ -61,17 +73,6 @@ Vanessa-ADD является наследником 2-х продуктов - [x
 + Скачать архив `add-x.x.x.zip` с последним стабильным релизом - прямая ссылка [Releases](https://github.com/silverbulleters/add/releases/latest)
 + Распаковать указанный архив в нужную папку.
 
-<a id="markdown-справка-и-полезные-ссылки" name="справка-и-полезные-ссылки"></a>
-## Справка и полезные ссылки
-
-Обязательно ознакомьтесь с:
-
-+ **Документацией по продукту** [doc/README.md](./doc/README.md)
-
-+ часто задаваемыми вопросами [FAQ.md](./F.A.Q.MD)
-+ руководством контрибьютора [CONTRIBUTING.md](./.github/CONTRIBUTING.md)
-+ известными проблемами [KNOWN-PROBLEMS.md](./doc/KNOWN-PROBLEMS.md)
-
 ## Ночная сборка ветки **develop**:
 
 Продукт помимо основного стабильного релиза, выпускается "ночная сборка" продукта с новым, но еще не стабильным функционалом. Артефакты сборки доступны на сервере сборок в двух форматах:

diff --git a/doc/README.md b/doc/README.md
@@ -2,7 +2,7 @@
 
 ## Каталог docs
 
-Предназначен для хранения файлов документации в формате Markdown 
+Предназначен для хранения файлов документации в формате Markdown
 
 Содержит:
 
@@ -11,7 +11,9 @@
 
 Для быстрого входа рекомендуем [почитать статьи или посмотреть видео](xdd/Статьи-и-видео-по-тестированию-в-1С.MD)
 
-[Документация по фреймворку Vanessa.Add - раздел xdd/tdd](/doc/xdd/README.MD)
+- [Описание возможностей готовых универсальных дымовых тестов](../tests/smoke/readme.md)
+- [Документация по разделу xdd/tdd](/doc/xdd/README.MD)
+- [BDD-Документация по фреймворку Vanessa.Add](doc/bdd/README.md)
 
 Vanessa.ADD работает только с платформой 1С версии 8.3.5 и выше в режиме совместимости с 8.3.5 и выше.
 
@@ -23,27 +25,30 @@ Vanessa.ADD работает только с платформой 1С верси
 
 ## Разделы справки
 
-* [Принципы написания тестов/фич/сценариев](xdd/Принципы-написания-тестов.MD)
-
-
-* [Методы проверки/утверждений для использования кода шагов/тестов](xdd/Методы-проверки---утверждения.MD)
-  * [Текучие (fluent) утверждения](xdd/Текучие-(fluent)-утверждения.MD) - очень красивые и довольно удобные. Можно выполнять несколько проверок в одной строке проверки.
-  * [Базовые утверждения](xdd/Базовые-утверждения.MD) - простые, устаревшие, но все еще замечательные утверждения.
-  * [Проверка таблиц и табличных документов](xdd/Проверка-таблиц-и-табличных-документов.MD)
-
-* [Система плагинов](xdd/Система-плагинов.MD)
-  * [Генерация данных](xdd/Генерация-данных.MD)
-  * [ВременныеФайлы](xdd/ВременныеФайлы.MD)
-  * [КомандныйФайл](xdd/КомандныйФайл.MD)
-  * [ПарсерКоманднойСтроки](xdd/ПарсерКоманднойСтроки.MD)
-  * [ЗапросыИзБД](xdd/ЗапросыИзБД.MD)
-  * [ЗагрузчикПользовательскихНастроек](xdd/Загрузчик-пользовательских-настроек.MD)
-  * [ГенераторОтчетаJUnitXML](xdd/ГенераторыОтчетов.MD#генераторотчетаjunitxml)
-  * Генераторы отчетов тестирования:
-    * [ГенераторОтчетаAllureXMLВерсия2](xdd/ГенераторыОтчетов.MD#генераторотчетаallurexmlверсия2)
-      * [(устаревший) ГенераторОтчетаAllureXML](xdd/ГенераторыОтчетов.MD#устаревший-генераторотчетаallurexml)
-    * [ГенераторОтчетаJUnitXML](xdd/ГенераторыОтчетов.MD#генераторотчетаjunitxml)
-    * [ГенераторОтчетаMXL](xdd/ГенераторыОтчетов.MD#генераторотчетаmxl)
-
-* [Дымовые тесты (тесты открытия всех форм)](../tests/smoke/readme.md)
-
+* [Обширная документация по BDD-части](./bdd/README.md)
+    * [Подготовка автодокументации - видео-документация и т.п.](https://github.com/silverbulleters/add/blob/develop/doc/bdd/%D0%BF%D0%BE%D0%B4%D0%B3%D0%BE%D1%82%D0%BE%D0%B2%D0%BA%D0%B0-%D0%B0%D0%B2%D1%82%D0%BE%D0%B4%D0%BE%D0%BA%D1%83%D0%BC%D0%B5%D0%BD%D1%82%D0%B0%D1%86%D0%B8%D0%B8.md)
+
+* Разделы по tdd-тесты кодом
+
+    * [Принципы написания тестов/фич/сценариев](xdd/Принципы-написания-тестов.MD)
+
+    * [Методы проверки/утверждений для использования кода шагов/тестов](xdd/Методы-проверки---утверждения.MD)
+        * [Текучие (fluent) утверждения](xdd/Текучие-(fluent)-утверждения.MD) - очень красивые и довольно удобные. Можно выполнять несколько проверок в одной строке проверки.
+        * [Базовые утверждения](xdd/Базовые-утверждения.MD) - простые, устаревшие, но все еще замечательные утверждения.
+        * [Проверка таблиц и табличных документов](xdd/Проверка-таблиц-и-табличных-документов.MD)
+
+    * [Система плагинов](xdd/Система-плагинов.MD)
+        * [Генерация данных](xdd/Генерация-данных.MD)
+        * [ВременныеФайлы](xdd/ВременныеФайлы.MD)
+        * [КомандныйФайл](xdd/КомандныйФайл.MD)
+        * [ПарсерКоманднойСтроки](xdd/ПарсерКоманднойСтроки.MD)
+        * [ЗапросыИзБД](xdd/ЗапросыИзБД.MD)
+        * [ЗагрузчикПользовательскихНастроек](xdd/Загрузчик-пользовательских-настроек.MD)
+        * [ГенераторОтчетаJUnitXML](xdd/ГенераторыОтчетов.MD#генераторотчетаjunitxml)
+        * Генераторы отчетов тестирования:
+                * [ГенераторОтчетаAllureXMLВерсия2](xdd/ГенераторыОтчетов.MD#генераторотчетаallurexmlверсия2)
+                    * [(устаревший) ГенераторОтчетаAllureXML](xdd/ГенераторыОтчетов.MD#устаревший-генераторотчетаallurexml)
+                * [ГенераторОтчетаJUnitXML](xdd/ГенераторыОтчетов.MD#генераторотчетаjunitxml)
+                * [ГенераторОтчетаMXL](xdd/ГенераторыОтчетов.MD#генераторотчетаmxl)
+
+    * [Дымовые тесты (тесты открытия всех форм)](../tests/smoke/readme.md)
diff --git a/doc/bdd/README.md b/doc/bdd/README.md
@@ -1,4 +1,9 @@
-## Описание использования в режиме BDD
+## Разделы
+
+* Описание использования в режиме BDD и т.д.
+* [Подготовка автодокументации - видео-документация и т.п.](https://github.com/silverbulleters/add/blob/develop/doc/bdd/%D0%BF%D0%BE%D0%B4%D0%B3%D0%BE%D1%82%D0%BE%D0%B2%D0%BA%D0%B0-%D0%B0%D0%B2%D1%82%D0%BE%D0%B4%D0%BE%D0%BA%D1%83%D0%BC%D0%B5%D0%BD%D1%82%D0%B0%D1%86%D0%B8%D0%B8.md)
+
+### Описание использования в режиме BDD
 
 + пишем feature-файлы в формате Gherkin
   + обычно используется редактор Visual Studio Code с расширением для Gherkin-файлов
@@ -36,7 +41,7 @@
   И при нажатии кнопки "Запустить сценарии" я вижу автоматизированный запуск обработок с признаком "pending" (ожидает реализации)
 ```
 
-### Классический вариант использования (без интерактивного режима)
+#### Классический вариант использования (без интерактивного режима)
 
 Фактически классический вариант использования представляет собой следующий рутинный порядок
 
@@ -48,7 +53,7 @@
 + запустили сценарии проверки поведения
 + убедились, что сценарии проверки работают, и отчет о проверки показывает "Зелёный" статус
 
-### Использования в режиме проверки поведения пользовательского интерфейса ("кнопко-нажималки")
+#### Использования в режиме проверки поведения пользовательского интерфейса ("кнопко-нажималки")
 
 для команд, уже имеющих функционал или производящих доработку типовых конфигураций в режиме Taxi, действует упрощенный порядок использования
 
@@ -62,7 +67,7 @@
 + запустили сценарии проверки поведения
 + убедились, что сценарии проверки работают и отчет о проверки показывает "Зелёный" статус
 
-### Кто пишет feature-файлы ?
+#### Кто пишет feature-файлы ?
 
 Обратите внимание, что фактически feature-файлы могут писать все участники команды: