1 В избранное 0 Ответвления 0

OSCHINA-MIRROR/mirrors-ZeroClipboard_old1

Присоединиться к Gitlife
Откройте для себя и примите участие в публичных проектах с открытым исходным кодом с участием более 10 миллионов разработчиков. Приватные репозитории также полностью бесплатны :)
Присоединиться бесплатно
Клонировать/Скачать
CONTRIBUTING.md 7.5 КБ
Копировать Редактировать Web IDE Исходные данные Просмотреть построчно История
gitlife-traslator Отправлено 26.11.2024 14:40 c2778ef

Участие

Привет! Мы рады, что вы хотите внести свой вклад в этот проект. Ваша помощь очень важна для его развития.

Использование системы отслеживания проблем

Система отслеживания проблем issue tracker является предпочтительным каналом для [сообщений об ошибках](#сообщения об ошибках), [запросов функций](#запросы функций) и [подачи запросов на включение изменений](#запросы на включение изменений), но, пожалуйста, соблюдайте следующие ограничения:

  • Пожалуйста, не используйте систему отслеживания проблем для личных запросов поддержки.
  • Пожалуйста, не отвлекайте обсуждение или тролльте проблемы. Поддерживайте обсуждение по теме и уважайте мнения других.

Сообщения об ошибках

Ошибка — это очевидная проблема, вызванная кодом в репозитории. Хорошие сообщения об ошибках очень полезны, так что спасибо!

Рекомендации по сообщениям об ошибках:

  1. Используйте поиск по проблемам GitHub — проверьте, не была ли проблема уже зарегистрирована.

  2. Проверьте, была ли проблема исправлена — попробуйте воспроизвести её, используя последнюю версию master или ветку разработки в репозитории.

Хорошее сообщение об ошибке не должно оставлять другим необходимости запрашивать у вас дополнительную информацию. Пожалуйста, постарайтесь быть как можно более подробными в своём отчёте. Какая у вас среда? Какие шаги воспроизведут проблему? В каких браузерах и ОС возникает проблема? Показывают ли другие браузеры ошибку по-другому? Какого результата вы ожидаете? Все эти детали помогут людям исправить любые потенциальные ошибки.

Пример:

Краткое и описательное название отчёта об ошибке

Резюме проблемы и среды браузера/ОС, в которой она возникает. Если возможно, включите шаги, необходимые для воспроизведения ошибки.

  1. Это первый шаг
  2. Это второй шаг
  3. Дальнейшие шаги и т. д.

Любая другая информация, которую вы хотите предоставить и которая имеет отношение к сообщаемой проблеме. Сюда могут входить строки кода, которые вы определили как вызывающие ошибку, и возможные решения (и ваше мнение об их достоинствах).

Запросы функций

Запросы функций приветствуются. Но найдите время, чтобы узнать, соответствует ли ваша идея объёму и целям проекта. Именно вы должны привести убедительные аргументы, чтобы убедить разработчиков проекта в достоинствах этой функции. Пожалуйста, предоставьте как можно больше деталей и контекста.

У нас есть roadmap.md с функциями, которые мы хотим реализовать. Вы можете добавить нужные вам функции туда или просто написать код функции и отправить запрос на включение изменений.

Запросы на включение изменений

Хорошие запросы на включение изменений — патчи, улучшения, новые функции — являются фантастической помощью. Они должны оставаться сосредоточенными и избегать содержания несвязанных коммитов.

Пожалуйста, спросите сначала, прежде чем приступать к любому значительному запросу на включение изменений (например, реализация функций, рефакторинг кода, перенос на другой язык), иначе вы рискуете потратить много времени на работу над тем, что разработчики проекта могут не захотеть включить в проект.

Следование следующему процессу — лучший способ включить вашу работу в проект:

  1. Форкните и клонируйте репозиторий.
  2. Создайте новую ветку: git checkout -b my-branch-name.
  3. Внесите изменения, добавьте тесты и убедитесь, что тесты всё ещё проходят.
  4. Отправьте в свой форк и отправьте запрос на включение изменений.
  5. Похлопайте себя по спине и ждите, пока ваш запрос на включение изменений будет рассмотрен и объединён.

Вот несколько вещей, которые вы можете сделать, чтобы увеличить вероятность принятия вашего запроса на включение изменений:

  • Сделайте ваши изменения максимально сфокусированными. Если есть несколько изменений, которые вы хотели бы внести и которые не зависят друг от друга, рассмотрите возможность отправки их в виде отдельных запросов на включение изменений.
  • Напишите хорошее сообщение о коммите.

Ресурсы

Опубликовать ( 0 )

Вы можете оставить комментарий после Вход в систему

1
https://api.gitlife.ru/oschina-mirror/mirrors-ZeroClipboard_old1.git
git@api.gitlife.ru:oschina-mirror/mirrors-ZeroClipboard_old1.git
oschina-mirror
mirrors-ZeroClipboard_old1
mirrors-ZeroClipboard_old1
master