первая стабильная версия, адаптированная для проекта behavior https://github.com/silverbulleters/vanessa-behavior/issues/64

расширено описание, возможны опечатки

Signed-off-by: Alexey Lustin <alustin@silverbulleters.org>

README.md

@@ -36,14 +36,24 @@ git pull bootstrap <ваша текущая ветка разработки>
 
 ### Возможности доработки шаблона
 
-* откройте issue - тогда можно обсудить необходимость адаптации под ваши задачи
+* откройте issue - если вам не хватает кого-то каталога под ваши задачи
 * войдите в чат Gitter - чтобы задать дополнительные вопросы 
 * сделайте fork, внесите изменения и выполните pull request с предлагаемыми вами изменениями (fork и pull request - это кнопки на GitHub.)
 
+~~~
+Важно !!!
+
+В структуре каталогов в ближайшее время НЕ будет каталога tests, это наша осознанная на данный момент позициция. По следующим причинам:
+
+* тестирование это процесс, для него мы используем каталог функциональности(./features) и каталог сценариев тестирования (./features/**/steps_definitions)
+* в 1С мире наличие низкоуровневых тестов (unittest'ов) слишком избыточным за счёт формата самой платформы 1С, которая является реализацией концепции DSL.
+* каталог tests может появиться только в случаях когда будет иметься практика построения интеграционных тестов, например с помощью проектов JMeter
+
+если вы не согласны с этим - то тогда вам подойдёт какой-нибудь другой альтернативный проект
+~~~
+
+
 ### Заметки на полях
 
-* структура в перспективе будет содержать и адаптацию семантики каталогов для проектов на проекте Graphite от компании 1С после появления официального стабильного релиза
+* структура в перспективе будет содержать и адаптацию семантики каталогов для проектов на проекте Graphite от компании 1С после появления официального стабильного релиза - пример текущего каталога из проекта Grathite можно посмотреть тут https://github.com/1C-Company/dt-demo-configuration/tree/master/DemoConfDT
 
-~~~
-TODO - дополнить и расширить описание и документацию
-~~~

doc/README.md

@@ -1 +1,11 @@
-1
+### Каталог docs
+
+Предназначен для хранения файлов документации в формате Markdown 
+
+Содержит:
+
+* рекомендаций разработчикам и команде проекта
+* описание релизов (RELEASE NOTES) и оперативного плана (ROADMAP)
+
+Пользовательские инструкции хранятся в WiKi проекта
+

examples/README.md

@@ -1 +1,3 @@
-1
+### Каталог example
+
+предназначен для хранения примеров кода c расширением bsl и хранения текстовых описаний на языках Gherkin и Markdown

features/README.md

@@ -1,8 +1,3 @@
-# Êîìïîíåíòû è ôóíêöèîíàëüíîñòü
+# Каталог features
 
-* Core - 
-* Libraries - 
-* Support - 
-* StepsGenerator - 
-* StepsRunner - 
-* UITestRunner - 
+Компоненты и функциональность продукта и автоматизированные сценарии проверки структурированные по подсистемам и объектам продукта

lib/README.md

@@ -1 +1,3 @@
-1
+### Каталог lib
+
+Предназначен для хранения внешних отчетов и обработок необходимых для работы продукта, разработанные в рамках создания продукта и не являющиеся сторонними разработками

src/README.md

@@ -1 +1,9 @@
-1
+### Каталог src
+
+Предназначен для хранения исходных текстов решения созданных на платформе 1С:Предприятие, содержит:
+
+исходные коды разработанные с помощью проекта Graphite
+исходные коды интегрированные их хранилища 1С с помощью проекта vanessa-unpack
+исходные коды обработок интегрированные с помошью проекта precommit1C
+
+

tools/README.md

@@ -1 +1,3 @@
-1
+### Каталог tools
+
+Предназначен для хранения любых сторонних утилит, необходимых для настройки проекта или для дополнительно установки