Привет! Мы рады, что вы хотите внести свой вклад в этот проект. Ваша помощь очень важна для его развития.
Система отслеживания проблем issue tracker является предпочтительным каналом для [сообщений об ошибках](#сообщения об ошибках), [запросов функций](#запросы функций) и [подачи запросов на включение изменений](#запросы на включение изменений), но, пожалуйста, соблюдайте следующие ограничения:
Ошибка — это очевидная проблема, вызванная кодом в репозитории. Хорошие сообщения об ошибках очень полезны, так что спасибо!
Рекомендации по сообщениям об ошибках:
Используйте поиск по проблемам GitHub — проверьте, не была ли проблема уже зарегистрирована.
Проверьте, была ли проблема исправлена — попробуйте воспроизвести её, используя последнюю версию master
или ветку разработки в репозитории.
Хорошее сообщение об ошибке не должно оставлять другим необходимости запрашивать у вас дополнительную информацию. Пожалуйста, постарайтесь быть как можно более подробными в своём отчёте. Какая у вас среда? Какие шаги воспроизведут проблему? В каких браузерах и ОС возникает проблема? Показывают ли другие браузеры ошибку по-другому? Какого результата вы ожидаете? Все эти детали помогут людям исправить любые потенциальные ошибки.
Пример:
Краткое и описательное название отчёта об ошибке
Резюме проблемы и среды браузера/ОС, в которой она возникает. Если возможно, включите шаги, необходимые для воспроизведения ошибки.
- Это первый шаг
- Это второй шаг
- Дальнейшие шаги и т. д.
Любая другая информация, которую вы хотите предоставить и которая имеет отношение к сообщаемой проблеме. Сюда могут входить строки кода, которые вы определили как вызывающие ошибку, и возможные решения (и ваше мнение об их достоинствах).
Запросы функций приветствуются. Но найдите время, чтобы узнать, соответствует ли ваша идея объёму и целям проекта. Именно вы должны привести убедительные аргументы, чтобы убедить разработчиков проекта в достоинствах этой функции. Пожалуйста, предоставьте как можно больше деталей и контекста.
У нас есть roadmap.md с функциями, которые мы хотим реализовать. Вы можете добавить нужные вам функции туда или просто написать код функции и отправить запрос на включение изменений.
Хорошие запросы на включение изменений — патчи, улучшения, новые функции — являются фантастической помощью. Они должны оставаться сосредоточенными и избегать содержания несвязанных коммитов.
Пожалуйста, спросите сначала, прежде чем приступать к любому значительному запросу на включение изменений (например, реализация функций, рефакторинг кода, перенос на другой язык), иначе вы рискуете потратить много времени на работу над тем, что разработчики проекта могут не захотеть включить в проект.
Следование следующему процессу — лучший способ включить вашу работу в проект:
git checkout -b my-branch-name
.Вот несколько вещей, которые вы можете сделать, чтобы увеличить вероятность принятия вашего запроса на включение изменений:
Вы можете оставить комментарий после Вход в систему
Неприемлемый контент может быть отображен здесь и не будет показан на странице. Вы можете проверить и изменить его с помощью соответствующей функции редактирования.
Если вы подтверждаете, что содержание не содержит непристойной лексики/перенаправления на рекламу/насилия/вульгарной порнографии/нарушений/пиратства/ложного/незначительного или незаконного контента, связанного с национальными законами и предписаниями, вы можете нажать «Отправить» для подачи апелляции, и мы обработаем ее как можно скорее.
Опубликовать ( 0 )