Поделиться через

Просмотр открытых запросов на вытягивание в GitHub

  • Статья

В этой статье объясняется, как внести свой вклад в Microsoft Learn, просмотрив запросы на вытягивание (PR) и добавив комментарии. Вы можете читать новые разделы и просматривать предлагаемые обновления перед публикацией, проверка открытой очереди pr репозитория GitHub. Отзывы пользователей о предлагаемых обновлениях идут на пользу всему сообществу.

С помощью комментариев и отзывов вы можете:

  • Добавьте и ответьте на комментарии по PR.
  • Реагируйте на комментарии с эмодзи, например 👍, ❤️ и 🎉 .

Необходимые компоненты

Поиск PR

  1. В браузере перейдите к репозиторию в GitHub, который вы хотите просмотреть. Если вы не уверены, какой репозиторий следует просмотреть, найдите его в нашем списке репозиториев Microsoft Learn.

    Если вы просматриваете документацию и не знаете, к какой репозиторию он принадлежит, выберите значок "Изменить карандаш" в верхней части страницы. Это действие принимает вас в исходный файл на GitHub. Имя репозитория отображается в левом верхнем углу страницы. Например, на следующем рисунке показано расположение имени репозитория для репозитория azure-dev-docs .

    Screenshot of a GitHub article page showing the repo name in the upper left-hand corner of the page.

  2. Перейдите на вкладку "Запросы на вытягивание", чтобы просмотреть открытые PR для этого репозитория. Если репозиторий имеет много PR, используйте панель фильтров для фильтрации по меткам, автору и многому другому. Или используйте панель поиска для поиска конкретных запросов.

    Screenshot of a GitHub repo showing the pull requests tab.

  3. Откройте pr, выбрав ссылку заголовка.

Просмотр pr

  1. На вкладке "Файлы изменены ".

    Screenshot of tabs on the GitHub pull request page. The tab titled Files Changed is highlighted.

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

    Screenshot of a GitHub Files Changed page. An example of original content highlighted in red and edited content highlighted in green is displayed.

  3. Добавьте примечания или предложить изменения, выбрав значок плюса (+) слева от строки, о которую вы хотите закомментировать. Чтобы выбрать несколько строк, выберите и перетащите знак плюса.

    Screenshot of a GitHub Files Changed page. The plus sign icon, intended for the user to select to enter in-line comments, is featured.

    Вы можете добавлять только комментарии или предложения в строки, которые были изменены в текущем PR. Чтобы внести другие изменения, измените этот файл в собственном PR.

  4. Откроется поле. Введите комментарии или вопросы. Если вы хотите, можно использовать кнопки на панели инструментов для форматирования текста, добавления маркированных и нумерованных списков или вставки блоков кода и изображений.

    Screenshot of a GitHub Files Changed page. The comment box element is featured.

  5. Вы также можете предложить изменение текста в этой строке.

    1. На панели инструментов для комментария выберите +- значок (вероятно, значок слева). Это кнопка "Вставить предложение".

      Screenshot of tabs in a comment box on the GitHub Files Changed page. The tab with a + and - icon is highlighted.

    2. Текст из выбранной строки будет включен в блок кода (внутри двух наборов обратных символов '').

      Screenshot of a comment box on the GitHub Files Changed page. An example of how to write the syntax for a suggestion is displayed.

      Чтобы предложить изменения в тексте, включающем забор кода с тройным галочку ('), замените внешние и заключающие suggestion обратные знаки тильдами (~~~).

    3. Измените текст. Используйте кнопки в поле комментариев для простого форматирования, например полужирного шрифта, курсивов и маркеров, или непосредственного использования элементов синтаксиса Markdown. Вы также можете добавить комментарии в это поле под разделом блока кода.

  6. После того как вы сделали комментарий, нажмите кнопку "Начать проверку". Автор pr будет уведомлен о ваших изменениях. Если вы использовали кнопку "Вставить предложение " на предыдущем шаге, автор сможет зафиксировать предложение непосредственно в документе.

    Если вы хотите перенести кого-то другого в беседу, вы можете @упоминание другие участник по псевдониму GitHub в комментариях. Упомянутые пользователи GitHub получат сообщение электронной почты, содержащее комментарий. Вы также можете использовать Markdown в комментариях, и при отправке комментария markdown отрисовывается.

  7. На вкладке "Беседы" прочитайте комментарии. Если у вас есть вопросы или комментарии, добавьте их в беседу. Вы также можете добавить реакции на комментарии, выбрав значок смайлика в левом нижнем углу каждого комментария.

Отправка проверки

После добавления всех комментариев в рецензирование отправьте отзыв.

  1. Нажмите кнопку "Просмотр изменений" в правом верхнем углу вкладки "Файлы", чтобы открыть диалоговое окно отправки проверки.
  2. Введите описательную сводку проверки.
  3. Нажмите переключатель для нужного типа проверки, а затем нажмите кнопку "Отправить отзыв".

Submitting a review in GitHub.

Автор pr получит уведомление о проверке.

Следующие шаги

Чтобы узнать больше о комментариях и отзывах, проверка эти статьи в документации GitHub.