Прочитать на английском

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


Участие в документации по совместной работе Майкрософт

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

Важно!

Все репозитории, публикуемые в Microsoft Learn, приняли Microsoft Open Source Code of Conduct. См. дополнительные сведения на странице вопросов и ответов о правилах поведения. Также вы можете отправить свои вопросы и комментарии по адресу opencode@microsoft.com.

Незначительные исправления или пояснения к примерам документации и кода в общедоступных репозиториях охватываются условиями использования learn.microsoft.com. Если новые или значительные изменения вносят не сотрудники корпорации Майкрософт, в комментариях к запросу на вытягивание на сайте GitHub появится предложение принять условия лицензионного соглашения с участником (CLA). Вам нужно заполнить онлайн-форму, после чего мы сможем принять ваш запрос на внесение изменений.

Как внести изменения

Чтобы предложить изменение, выполните следующие действия. Снимки экрана
1. Если вы просматриваете страницу Microsoft Learn, нажмите кнопку "Изменить" в правом верхнем углу страницы. Вы перейдете к соответствующему исходному файлу в формате Markdown в репозитории GitHub. Кнопка
2. Если у вас еще нет учетной записи GitHub, щелкните "Зарегистрироваться " в правом верхнем углу и создайте новую учетную запись. Кнопка регистрации
3. На открывающейся странице GitHub нажмите кнопку "Изменить" (значок карандаша). Кнопка карандаша
4. В области редактирования файлов используйте язык Markdown, чтобы внести изменения в содержимое. (Как записать markdown.) Изменение файла
5. Нажмите кнопку "Предварительный просмотр изменений", чтобы убедиться, что форматирование выглядит должным образом. Предварительные изменения
6. По завершении прокрутите страницу вниз и нажмите кнопку "Предложить изменение файла", появится страница "Сравнение изменений", позволяющая проверить изменения. Затем нажмите кнопку "Создать запрос на вытягивание", чтобы отправить изменения. На этом этапе все готово. Предложение изменения

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

*Только для внутренней проверки изменения отображаются на промежуточном сайте.

Работа с ветвями

Репозиторий GitHub для совместной работы MS использует две основные родительские ветви: mainэто содержимое можно просмотреть на промежуточном сайте и liveдля содержимого, отображаемого на активном сайте.

При внесении изменений отправьте запрос на вытягивание (PR) в ветвь main . Эта ветвь доступна для просмотра на промежуточном сайте и в ней содержатся только те материалы, которые готовы к публикации на общедоступном сайте. Вы также можете создать и отправить ветвь с уникальным именем ветви, которую можно выбрать и просмотреть на промежуточном сайте. ( Динамическая ветвь разрешена только администраторам содержимого.)

Использование проблем для предоставления отзывов по документации по СОВМЕСТНОЙ работе MS

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

Обязательно укажите заголовок раздела и URL-адрес, если вы создаете проблему, связанную с определенной страницей.

Благодарим вас за поддержку этого содержимого!