fixed artbear#1

* немного покреативил с параметрыми качества
* добавил автобота для поиска
* расширил ссылками основную документацию

CONTRIBUTING.md

@@ -1,8 +1,28 @@
 # Коллективное наполнение списка
 
+> всё невозможно найти, но если искать всем, то всё найти можно (с)  
+
 ## Порядок добавления
 
-* просмотреть текущий список перед добавление чего-либо, так как Ваше изменение может быть "дубликатом"
-* для каждого продукта делать отдельный pull request
-* придерживаться стиля [Имя проекта](ссылка на проект)
-* каждый продукт должен быть категоризирован, если категории не существует - необходимо сделать pull request на неё
+* Вы нашли/создали на GitHub интересный проект
+* Вы хотите добавить это проект в общий список
+* Просмотрите текущий список перед добавление чего-либо, так как Ваше изменение может быть "дубликатом"
+* Для каждого продукта сделайте отдельный `pull request` через концепцию `fork -> clone -> commit -> push my-fork -> pull request`
+* Придерживайтесь стиля `[Имя проекта](ссылка на проект)` (cинтаксиc Markdown для создания ссылок)
+* Каждый продукт должен быть категоризирован, если категории не существует - необходимо сделать `pull request` на неё или просто добавьте интересующий Вас проект в секцию `Без категории`
+
+## Глоссарий
+
+* `pull request` - "предложение изменений с контролем Вашего авторства", кнопка в переводе на русский означает `Запрос на изменение`
+* `fork -> clone -> commit -> push my-fork -> pull request` - процесс участия в открытом проекте, подразумевающий нажатие кнопок:
+  * `Fork` - "сделать свою копию списка" на сервере GitHub
+  * `Clone` - "скопировать список на локальный компьютер разработчика" с сервера GitHub
+  * `Commit` - "фиксация изменений для себя"
+  * `Push my-fork` - "опубликовать изменения в свою копию списка" на сервере GitHub
+  * `Pull request` - "предложение о добавлении программы в общий список на этом проект" - данный шаг и делает Вас "контрибьютором"
+
+## Автоматизированный поиск
+
+* каждый день, ровно в полдень `автоматизированный бот` используя скрипт из каталога `tools` запускает обновление "сырых" данных по поиску репозиториев на GitHub 
+* `автоматизированный бот` помещает изменения в каталог `data` и публикует их на GitHub
+* если в каталоге `data` есть что-нибудь новое и интересное работает `мозг` и правила описанные в разделе `Порядок добавления`

README.md

@@ -67,6 +67,8 @@
 
 ### Потенциально интересное (без категорий)
 
+**Ручной поиск**
+
 * https://github.com/purtcer/NurseConsole1CServer
 * https://github.com/TeamBIOS/cfg_tools
 * https://github.com/EnterraInc/1C-.Net-Adapter
@@ -80,7 +82,12 @@
 * https://github.com/1CEnterprise/MSQL-for-1C
 * https://github.com/asdaru/postgres_1c
 
+**Автоматический поиск**
+
+[Данные согласно поиску GitHub](data/README.md)
+
+[Инструкция по скриптам поиска](tools/README.md)
+
 ## License
 
 [![CC0](https://i.creativecommons.org/p/zero/1.0/88x31.png)](https://creativecommons.org/publicdomain/zero/1.0/)
-

tools/README.md

@@ -1,18 +1,19 @@
-## Скрипты помошники актуализации списка
+# Скрипты помошники актуализации списка
 
-### Требования:
+## Требования
 
 * установленный `VSC` с пакетом `1C (BSL)`
-* `oscript` - http://oscript.io 
+* `oscript` - http://oscript.io
 
-### Запуск скриптов
+## Запуск скриптов
 
-* `git submodule update --init --recursive`
-* `Ctrl+Shift+B` - в Visual Studio Code
+* `git submodule update --init --recursive` - обновление подмодулей скриптов
+* `search-start.cmd` - запуск поиска
+
+или напрямую из консоли:
 
-или напрямую из консоли - например:
 `oscript ./tools/github-stats/bsl-github-stats.os generate-markdown --markdown-path data\\README.md`
 
-### Просмотр данных
+## Просмотр данных
 
 * смотрите каталог `data/README.md` - результатом работы скрипта является файл Markdown с текущей статистикой