Мы будем рады, если вы внесёте свой вклад в развитие топологии и поможете сделать её ещё лучше! Вот наши рекомендации для участников:
Если вы обнаружили ошибку в исходном коде, вы можете помочь нам, отправив сообщение об ошибке в наш репозиторий на GitHub. Ещё лучше — отправьте запрос на изменение с исправлением.
Вы можете попросить новую функцию, отправив сообщение о проблеме в наш репозиторий на GitHub. Если вы хотите реализовать новую функцию, сначала отправьте сообщение о проблеме с запросом на работу. Это позволит нам понять, сможем ли мы использовать вашу идею. Пожалуйста, подумайте, какое это изменение:
Прежде чем отправлять сообщение о проблеме, пожалуйста, поищите в трекере проблем, возможно, проблема уже существует и обсуждение может подсказать вам доступные решения.
Мы хотим исправить все проблемы как можно скорее, но перед исправлением ошибки нам нужно воспроизвести и подтвердить её. Чтобы воспроизвести ошибки, мы будем систематически просить вас предоставить минимальный сценарий воспроизведения с помощью http://plnkr.co. Наличие живого воспроизводимого сценария даёт нам массу важной информации без необходимости задавать дополнительные вопросы, такие как:
Минимальный сценарий воспроизведения с использованием http://plnkr.co/ позволяет нам быстро подтвердить наличие ошибки (или указать на проблему в коде), а также убедиться, что мы исправляем правильную проблему. Если plunker не подходит для демонстрации проблемы (например, для проблем, связанных с нашей упаковкой npm), создайте отдельный репозиторий git, демонстрирующий проблему.
Мы настаиваем на минимальном сценарии воспроизведения, чтобы сэкономить время разработчиков и в конечном итоге исправить больше ошибок. Интересно, что, по нашему опыту, пользователи часто сами находят проблемы в коде при подготовке минимального plunk. Мы понимаем, что иногда бывает трудно извлечь важные фрагменты кода из большой базы кода, но нам действительно нужно изолировать проблему, прежде чем мы сможем её исправить.
К сожалению, мы не можем исследовать или исправлять ошибки без минимального воспроизведения, поэтому, если мы не получим от вас ответа, мы закроем проблему, для которой недостаточно информации для воспроизведения.
Вы можете создать новое сообщение о проблеме, заполнив нашу форму создания новой проблемы.
Перед отправкой запроса на изменение рассмотрите следующие рекомендации:
Поищите на GitHub открытые или закрытые PR, связанные с вашей отправкой. Вы не хотите дублировать усилия.
Внесите изменения в новую ветку git:
git checkout -b my-fix-branch master
Создайте патч, включая соответствующие тестовые случаи.
Следуйте нашим правилам кодирования.
Запустите полный набор тестов топологии , и убедитесь, что все тесты пройдены.
Фиксация изменений с использованием описательного сообщения о фиксации, которое соответствует нашим соглашениям о сообщениях о фиксации. Соблюдение этих соглашений необходимо, поскольку примечания к выпуску автоматически генерируются на основе этих сообщений.
git commit -a
``` **Опция будет автоматически добавлять и удалять отредактированные файлы.**
Отправьте изменения в ветку на GitHub:
git push origin my-fix-branch
На GitHub отправьте pull request в topology:master
.
Если мы предложим внести изменения, то:
Внесите необходимые обновления.
Заново запустите тестовые наборы топологии, чтобы убедиться, что тесты всё ещё проходят.
Перебазируйте вашу ветку и принудительно отправьте изменения в ваш репозиторий на GitHub (это обновит ваш запрос на pull):
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. Это приводит к более читаемым сообщениям, которые легко отслеживать при просмотре истории проекта. Кроме того, мы используем сообщения git commit для создания журнала изменений топологии.
Каждое сообщение о фиксации состоит из заголовка, тела и нижнего колонтитула. Заголовок имеет специальный формат, который включает тип, область действия и тему:
<type>(<scope>): <subject>
<BLANK LINE>
<body>
<BLANK LINE>
<footer>
Заголовок является обязательным, а область действия заголовка — необязательной.
Любая строка сообщения о фиксации не должна превышать 100 символов! Это позволяет сообщению легче читаться на GitHub, а также в различных инструментах git.
Нижний колонтитул должен содержать закрывающую ссылку на проблему, если таковая имеется.
Примеры: (ещё больше примеров)
docs(changelog): обновить журнал изменений до beta.5
fix(release): необходимо зависеть от последних rxjs и zone.js
Версия в нашем package.json копируется в ту, которую мы публикуем, и пользователям нужна последняя из них.
Если фиксация отменяет предыдущую фиксацию, она должна начинаться с revert: , за которым следует заголовок отменённой фиксации. В теле должно быть написано: «Это отменяет фиксацию <хэш>», где хэш — это SHA отменяемой фиксации.
Должен быть одним из следующих:
Тема содержит краткое описание изменения:
Как и в теме, используйте повелительное наклонение, настоящее время: «измените», а не «изменённое» или «изменение». Тело должно включать мотивацию для изменения и противопоставлять его предыдущему поведению.
Нижний колонтитул должен содержать любую информацию о критических изменениях и также является... Место для ссылки на проблемы GitHub, которые закрывает этот коммит.
Критические изменения должны начинаться со слова BREAKING CHANGE: с пробелом или двумя переносами строк. Остальная часть сообщения коммита используется для этого.
Подробное объяснение можно найти в этом документе.
Вы можете оставить комментарий после Вход в систему
Неприемлемый контент может быть отображен здесь и не будет показан на странице. Вы можете проверить и изменить его с помощью соответствующей функции редактирования.
Если вы подтверждаете, что содержание не содержит непристойной лексики/перенаправления на рекламу/насилия/вульгарной порнографии/нарушений/пиратства/ложного/незначительного или незаконного контента, связанного с национальными законами и предписаниями, вы можете нажать «Отправить» для подачи апелляции, и мы обработаем ее как можно скорее.
Опубликовать ( 0 )