mirror of
https://github.com/MicrosoftDocs/windows-itpro-docs.git
synced 2025-06-25 23:33:35 +00:00
[BULK UPDATE] DocuTune - Rebranding
This commit is contained in:
@ -1,8 +1,6 @@
|
||||
# Editing Windows IT professional documentation
|
||||
|
||||
Thank you for your interest in the Windows IT professional documentation! We appreciate your feedback, edits, and additions to our docs.
|
||||
This page covers the basic steps for editing our technical documentation.
|
||||
For a more up-to-date and complete contribution guide, see the main [contributor guide overview](https://docs.microsoft.com/contribute/).
|
||||
Thank you for your interest in the Windows IT professional documentation! We appreciate your feedback, edits, and additions to our content. This page covers the basic steps for editing our technical documentation. For a more up-to-date and complete contribution guide, see the main [contributor guide overview](https://learn.microsoft.com/contribute/).
|
||||
|
||||
## Sign a CLA
|
||||
|
||||
@ -19,10 +17,10 @@ We've tried to make editing an existing, public file as simple as possible.
|
||||
|
||||
### To edit a topic
|
||||
|
||||
1. Browse to the [Microsoft Docs](https://docs.microsoft.com/) article that you want to update.
|
||||
1. Browse to the [Microsoft Learn](https://learn.microsoft.com/) article that you want to update.
|
||||
|
||||
> **Note**<br>
|
||||
> If you're a Microsoft employee or vendor, before you edit the article, append `review.` to the beginning of the URL. This action lets you use the private repository, **windows-docs-pr**. For more information, see the [internal contributor guide](https://review.docs.microsoft.com/help/get-started/edit-article-in-github?branch=main).
|
||||
> If you're a Microsoft employee or vendor, before you edit the article, append `review.` to the beginning of the URL. This action lets you use the private repository, **windows-docs-pr**. For more information, see the [internal contributor guide](https://review.learn.microsoft.com/help/get-started/edit-article-in-github?branch=main).
|
||||
|
||||
1. Then select the **Pencil** icon.
|
||||
|
||||
@ -37,7 +35,7 @@ We've tried to make editing an existing, public file as simple as possible.
|
||||
|
||||

|
||||
|
||||
1. Using Markdown language, make your changes to the file. For info about how to edit content using Markdown, see the [Docs Markdown reference](https://docs.microsoft.com/contribute/markdown-reference) and GitHub's [Mastering Markdown](https://guides.github.com/features/mastering-markdown/) documentation.
|
||||
1. Using Markdown language, make your changes to the file. For info about how to edit content using Markdown, see the [Docs Markdown reference](https://learn.microsoft.com/contribute/markdown-reference) and GitHub's [Mastering Markdown](https://guides.github.com/features/mastering-markdown/) documentation.
|
||||
|
||||
1. Make your suggested change, and then select **Preview changes** to make sure it looks correct.
|
||||
|
||||
@ -57,16 +55,15 @@ We've tried to make editing an existing, public file as simple as possible.
|
||||
|
||||
The pull request is sent to the writer of the topic and your edits are reviewed. If your request is accepted, updates are published to their respective article. This repository contains articles on some of the following topics:
|
||||
|
||||
- [Windows client documentation for IT Pros](https://docs.microsoft.com/windows/resources/)
|
||||
- [Microsoft Store](https://docs.microsoft.com/microsoft-store)
|
||||
- [Windows 10 for Education](https://docs.microsoft.com/education/windows)
|
||||
- [Windows 10 for SMB](https://docs.microsoft.com/windows/smb)
|
||||
- [Internet Explorer 11](https://docs.microsoft.com/internet-explorer/)
|
||||
- [Windows client documentation for IT Pros](https://learn.microsoft.com/windows/resources/)
|
||||
- [Microsoft Store](https://learn.microsoft.com/microsoft-store)
|
||||
- [Windows 10 for Education](https://learn.microsoft.com/education/windows)
|
||||
- [Windows 10 for SMB](https://learn.microsoft.com/windows/smb)
|
||||
- [Internet Explorer 11](https://learn.microsoft.com/internet-explorer/)
|
||||
|
||||
## Making more substantial changes
|
||||
|
||||
To make substantial changes to an existing article, add or change images, or contribute a new article, you'll need to create a local clone of the content.
|
||||
For info about creating a fork or clone, see [Set up a local Git repository](https://docs.microsoft.com/contribute/get-started-setup-local). The GitHub docs topic, [Fork a Repo](https://docs.github.com/articles/fork-a-repo), is also insightful.
|
||||
To make substantial changes to an existing article, add or change images, or contribute a new article, you'll need to create a local clone of the content. For information about creating a fork or clone, see [Set up a local Git repository](https://learn.microsoft.com/contribute/get-started-setup-local). The [Fork a Repo](https://docs.github.com/articles/fork-a-repo) article is also helpful.
|
||||
|
||||
Fork the official repo into your personal GitHub account, and then clone the fork down to your local device. Work locally, then push your changes back into your fork. Finally, open a pull request back to the main branch of the official repo.
|
||||
|
||||
@ -82,4 +79,4 @@ In the new issue form, enter a brief title. In the body of the form, describe th
|
||||
|
||||
- You can use your favorite text editor to edit Markdown files. We recommend [Visual Studio Code](https://code.visualstudio.com/), a free lightweight open source editor from Microsoft.
|
||||
- You can learn the basics of Markdown in just a few minutes. To get started, check out [Mastering Markdown](https://guides.github.com/features/mastering-markdown/).
|
||||
- Microsoft technical documentation uses several custom Markdown extensions. To learn more, see the [Docs Markdown reference](https://docs.microsoft.com/contribute/markdown-reference).
|
||||
- Microsoft technical documentation uses several custom Markdown extensions. To learn more, see the [Docs Markdown reference](https://learn.microsoft.com/contribute/markdown-reference).
|
||||
|
Reference in New Issue
Block a user