Мы будем рады, если вы внесете свой вклад в ng-alain и поможете сделать его еще лучше, чем он есть сегодня! Вот рекомендации, которым мы хотели бы, чтобы вы следовали:
Если вы обнаружите ошибку в исходном коде, вы можете помочь нам, создав проблему в нашем репозитории GitHub. Еще лучше, вы можете отправить запрос на включение изменений с исправлением.
Вы можете попросить новую функцию, создав проблему в репозитории GitHub. Если вы хотите реализовать новую функцию, пожалуйста, сначала отправьте проблему с запросом на вашу работу, чтобы убедиться, что мы сможем ее использовать. Пожалуйста, подумайте, какое это изменение:
Прежде чем отправить проблему, пожалуйста, поищите в трекере проблем, возможно, проблема уже существует, и обсуждение может предоставить вам информацию о доступных обходных путях.
Мы хотим исправить все проблемы как можно скорее, но прежде чем исправлять ошибку, нам нужно воспроизвести и подтвердить ее. Чтобы воспроизвести ошибки, мы систематически попросим вас предоставить минимальный сценарий воспроизведения с помощью http://plnkr.co. Наличие живого воспроизводимого сценария дает нам массу важной информации без необходимости возвращаться к вам с дополнительными вопросами, такими как:
Минимальный сценарий воспроизведения с использованием http://plnkr.co/ позволяет нам быстро подтвердить ошибку (или указать на проблему в коде), а также подтвердить, что мы исправляем правильную проблему. Если plunker не подходит для демонстрации проблемы (например, для проблем, связанных с нашей упаковкой npm), создайте отдельный git-репозиторий, демонстрирующий проблему.
Мы настаиваем на минимальном сценарии воспроизведения, чтобы сэкономить время сопровождающих и в конечном итоге иметь возможность исправлять больше ошибок. Интересно, что, по нашему опыту, пользователи часто сами находят проблемы в коде при подготовке минимального plunk. Мы понимаем, что иногда бывает трудно извлечь важные фрагменты кода из более крупной базы кода, но нам действительно нужно изолировать проблему, прежде чем мы сможем ее исправить.
К сожалению, мы не можем исследовать / исправлять ошибки без минимального воспроизведения, поэтому, если мы не получим от вас ответа, мы закроем проблему, которой недостаточно информации для воспроизведения.
Вы можете создать новые проблемы, заполнив нашу форму создания новой проблемы.
Прежде чем отправлять запрос на включение изменений, рассмотрите следующие рекомендации:
Поиск GitHub для открытого или закрытого PR, связанного с вашей отправкой. Вы не хотите дублировать усилия.
Внесите изменения в новую ветку git:
git checkout -b my-fix-branch master
Создайте патч, включая соответствующие тестовые случаи.
Следуйте нашим правилам кодирования.
Запустите полный набор тестов ng-alain , и убедитесь, что все тесты пройдены.
Фиксация изменений с использованием описательного сообщения о фиксации, которое следует нашим соглашениям об оформлении сообщений о фиксации. Соблюдение этих соглашений необходимо, поскольку примечания к выпуску автоматически генерируются из этих сообщений.
git commit -a
``` **Автоматическое добавление и удаление отредактированных файлов**
Отправьте изменения в ветку на GitHub:
git push origin my-fix-branch
На GitHub отправьте pull request в ng-alain:master
.
Если мы предложим внести изменения, то:
git rebase master -i
git push -f
Это всё! Спасибо за ваш вклад!
После того как ваш запрос на включение будет объединён, вы можете безопасно удалить свою ветку и извлечь изменения из основного (восходящего) репозитория:
Удалите удалённую ветку на GitHub через веб-интерфейс GitHub или локальную оболочку следующим образом:
git push origin --delete my-fix-branch
Проверьте основную ветку:
git checkout master -f
Удалите локальную ветку:
git branch -D my-fix-branch
Обновите свой мастер последней версией восходящего потока:
git pull --ff upstream master
Чтобы обеспечить согласованность исходного кода, помните об этих правилах во время работы:
У нас есть очень точные правила относительно того, как можно форматировать сообщения git commit. Это приводит к более читаемым сообщениям, которые легко отслеживать при просмотре истории проекта. Кроме того, мы используем сообщения git commit для создания журнала изменений ng-alain.
Каждое сообщение о фиксации состоит из заголовка, тела и нижнего колонтитула. Заголовок имеет специальный формат, который включает тип, область действия и тему:
<type>(<scope>): <subject>
<BLANK LINE>
<body>
<BLANK LINE>
<footer>
Заголовок является обязательным, а область действия заголовка — необязательной.
Любая строка сообщения о фиксации не должна превышать 100 символов! Это позволяет сообщению легче читаться на GitHub, а также в различных инструментах git.
Нижний колонтитул должен содержать закрывающую ссылку на проблему, если таковая имеется.
Примеры: (ещё больше примеров)
docs(changelog): update change log to beta.5
fix(release): need to depend on latest rxjs and zone.js
The version in our package.json gets copied to the one we publish, and users need the latest of these.
Если фиксация отменяет предыдущую фиксацию, она должна начинаться с revert: , за которым следует заголовок отменённой фиксации. В теле должно быть написано: «Это отменяет фиксацию <хэш>», где хэш — это SHA фиксации, которую отменяют.
Должен быть одним из следующих:
Тема содержит краткое описание изменения:
Как и в теме, используйте повелительное наклонение, настоящее время: «измените», а не «изменённое» или «изменение». Тело должно включать мотивацию для изменения и противопоставлять его предыдущему поведению.
Нижний колонтитул должен содержать любую информацию о критических изменениях и также является местом для ссылки на проблемы GitHub, которые связаны с этой фиксацией. Closes.
Breaking Changes должны начинаться со слова BREAKING CHANGE: с пробелом или двумя переносами строки. Затем используется остальная часть сообщения коммита.
Подробное объяснение можно найти в этом документе.
Вы можете оставить комментарий после Вход в систему
Неприемлемый контент может быть отображен здесь и не будет показан на странице. Вы можете проверить и изменить его с помощью соответствующей функции редактирования.
Если вы подтверждаете, что содержание не содержит непристойной лексики/перенаправления на рекламу/насилия/вульгарной порнографии/нарушений/пиратства/ложного/незначительного или незаконного контента, связанного с национальными законами и предписаниями, вы можете нажать «Отправить» для подачи апелляции, и мы обработаем ее как можно скорее.
Опубликовать ( 0 )