Skip to content

Latest commit

 

History

History
39 lines (29 loc) · 4.03 KB

CONTRIBUTING.md

File metadata and controls

39 lines (29 loc) · 4.03 KB

Коллективное наполнение списка

всё невозможно найти, но если искать всем, то всё найти можно (с)

Порядок добавления

  • Вы нашли/создали на GitHub интересный проект
  • Вы хотите добавить это проект в общий список
  • Просмотрите текущий список перед добавление чего-либо, так как Ваше изменение может быть "дубликатом"
  • Для каждого продукта сделайте отдельный pull request через концепцию fork -> clone -> commit -> push my-fork -> pull request
  • Придерживайтесь стиля [Имя проекта](ссылка на проект) (cинтаксиc Markdown для создания ссылок)
  • Каждый продукт должен быть категоризирован, если категории не существует - необходимо сделать pull request на неё или просто добавьте интересующий Вас проект в секцию Без категории

Критерии качества

Очень бы хотелось чтобы добавляемый проект:

  • был полезен сообществу 1С специалистов - менеджерам, аналитикам, разработчикам, архитекторам, релиз-менеджерам и т.д.
  • имел файл лицензию с описанием порядка распространения и использования
  • имел активного автора или контрибьюторов, с активным акаунтом на GitHub
  • имел README.md файл с описанием проекта (как это принято на GitHub)
  • не нарушал авторские права других авторов, в частности самой компании 1С
  • имел непустые каталоги features или spec\\tests, подразумевающие что автор ведет разработку контролируя качество своего продукта

Глоссарий

  • 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 есть что-нибудь новое и интересное работает мозг и правила описанные в разделе Порядок добавления