From a554e7f64da761545ea06d0e117f7d2355cbcb38 Mon Sep 17 00:00:00 2001 From: Alexey Lustin Date: Sun, 22 May 2016 12:00:46 +0300 Subject: [PATCH] =?UTF-8?q?fixed=20#1=20*=20=D0=BD=D0=B5=D0=BC=D0=BD=D0=BE?= =?UTF-8?q?=D0=B3=D0=BE=20=D0=BF=D0=BE=D0=BA=D1=80=D0=B5=D0=B0=D1=82=D0=B8?= =?UTF-8?q?=D0=B2=D0=B8=D0=BB=20=D1=81=20=D0=BF=D0=B0=D1=80=D0=B0=D0=BC?= =?UTF-8?q?=D0=B5=D1=82=D1=80=D1=8B=D0=BC=D0=B8=20=D0=BA=D0=B0=D1=87=D0=B5?= =?UTF-8?q?=D1=81=D1=82=D0=B2=D0=B0=20*=20=D0=B4=D0=BE=D0=B1=D0=B0=D0=B2?= =?UTF-8?q?=D0=B8=D0=BB=20=D0=B0=D0=B2=D1=82=D0=BE=D0=B1=D0=BE=D1=82=D0=B0?= =?UTF-8?q?=20=D0=B4=D0=BB=D1=8F=20=D0=BF=D0=BE=D0=B8=D1=81=D0=BA=D0=B0=20?= =?UTF-8?q?*=20=D1=80=D0=B0=D1=81=D1=88=D0=B8=D1=80=D0=B8=D0=BB=20=D1=81?= =?UTF-8?q?=D1=81=D1=8B=D0=BB=D0=BA=D0=B0=D0=BC=D0=B8=20=D0=BE=D1=81=D0=BD?= =?UTF-8?q?=D0=BE=D0=B2=D0=BD=D1=83=D1=8E=20=D0=B4=D0=BE=D0=BA=D1=83=D0=BC?= =?UTF-8?q?=D0=B5=D0=BD=D1=82=D0=B0=D1=86=D0=B8=D1=8E?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- CONTRIBUTING.md | 28 ++++++++++++++++++++++++---- README.md | 9 ++++++++- tools/README.md | 17 +++++++++-------- 3 files changed, 41 insertions(+), 13 deletions(-) diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index a0508bd..eed630a 100644 --- a/CONTRIBUTING.md +++ b/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` есть что-нибудь новое и интересное работает `мозг` и правила описанные в разделе `Порядок добавления` diff --git a/README.md b/README.md index 379d8a1..6adfaac 100644 --- a/README.md +++ b/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/) - diff --git a/tools/README.md b/tools/README.md index 6a2ee97..2550d97 100644 --- a/tools/README.md +++ b/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 с текущей статистикой