Skip to content

Commit d0166de

Browse files
Merge pull request #13120 from MicrosoftDocs/main
[AutoPublish] main to live - 09/18 19:49 PDT | 09/19 08:19 IST
2 parents 71df4da + b15516d commit d0166de

17 files changed

+29
-21
lines changed

README.md

Lines changed: 20 additions & 20 deletions
Original file line numberDiff line numberDiff line change
@@ -1,14 +1,14 @@
11
---
2-
ms.date: 05/16/2025
2+
ms.date: 09/18/2025
33
---
44

55
# Overview
66

77
## Learn how to contribute
88

9-
Anyone who is interested can contribute to the articles. When you contribute, your work goes into the content set after it's been reviewed and merged. It's then published to [Microsoft Learn](https://learn.microsoft.com/), and you're listed as a contributor at: <https://github.com/MicrosoftDocs/office-docs-powershell/graphs/contributors>.
9+
Anyone interested can contribute to articles. When you contribute, your work goes into the content set after someone reviews and merges it. Your updates are published to [Microsoft Learn](https://learn.microsoft.com/), and you're listed as a contributor at: <https://github.com/MicrosoftDocs/office-docs-powershell/graphs/contributors>.
1010

11-
If you get stuck and are a Microsoft employee or vendor, post a message to [Ask an Admin](https://aka.ms/askanadmin).
11+
Microsoft employees or vendors who get stuck can post a question to [Ask an Admin](https://aka.ms/askanadmin).
1212

1313
### Quickly update an article using GitHub.com
1414

@@ -17,34 +17,34 @@ Contributors who make infrequent or small updates can edit the file directly on
1717
> [!TIP]
1818
> To edit an article, you need to get to it on the GitHub.com backend. If you're already on the GitHub.com page of the article, you're starting at step 4.
1919
>
20-
> Your permissions in the repo determine what you see in step 5 and later. People with no special privileges see the steps as described. People with permissions to approve their own pull requests see a similar experience with different button and page titles (for example, **Commit changes** instead of **Propose changes**), extra options for creating a new branch, and fewer confirmation pages. The point is: click any green buttons that are presented to you until there are no more.
20+
> Your permissions in the repo determine what you see in step 5 and later. People with no special privileges see the steps as described. People with permissions to approve their own pull requests see a similar experience with different button and page titles (for example, **Commit changes** instead of **Propose changes**), extra options for creating a new branch, and fewer confirmation pages. The point is: Select any green buttons presented to you until there are no more.
2121
22-
1. Verify that you're signed in to GitHub.com with your GitHub account.
23-
2. On learn.microsoft.com, find the article that you want to update.
24-
3. Above the title of the article, select ![Edit this document icon.](images/m365-cc-sc-edit-icon.png) **Edit this document**.
22+
1. Verify you're signed in to GitHub.com with your GitHub account.
23+
2. On learn.microsoft.com, find the article you want to update.
24+
3. Above the article title, select **** **More actions \> ![Edit icon.](images/quick-update-icon-learn-edit.png) **Edit**.
2525

26-
![Screenshot of how to select the Edit this document button on a learn.microsoft.com article.](images/quick-update-edit-button-on-learn-page.png)
26+
![Screenshot of how to select Edit on a learn.microsoft.com article.](images/quick-update-01-edit-button-on-learn-page.png)
2727

28-
4. The corresponding article file opens on GitHub. Select ![Edit icon.](images/quick-update-github-edit-icon.png) **Edit**.
28+
4. The corresponding article file opens on GitHub. Select ![Edit this file icon.](images/quick-update-icon-github-edit.png) **Edit this file**.
2929

30-
![Screenshot of how to select the Edit button on a GitHub article file.](images/quick-update-edit-button-on-github-page.png)
30+
![Screenshot of how to select Edit this file on a GitHub article file.](images/quick-update-02-edit-button-on-github-page.png)
3131

3232
5. If a **You need to fork this repository to propose changes** page opens, select **Fork this repository**.
3333

34-
![Screenshot of how to select Fork this repository on the You need to fork this repository to propose changes page.](images/quick-update-fork-this-repository-page.png)
34+
![Screenshot of how to select Fork this repository on the You need to fork this repository to propose changes page.](images/quick-update-03-fork-this-repository-page.png)
3535

3636
6. The article file opens in a line-numbered editor page where you can make updates.
3737

3838
Articles on learn.microsoft.com are formatted using the Markdown language. For help on using Markdown, see [Mastering Markdown](https://guides.github.com/features/mastering-markdown/).
3939

4040
> [!TIP]
41-
> Cmdlet reference articles follow a very strict schema with limited formatting options, because the articles are also converted and used for help at the command line (`Get-Help <CmdletName>`). Use existing content as a guide. For more information, see [platyPS Schema](https://github.com/PowerShell/platyPS/blob/master/docs/developer/platyPS/platyPS.schema.md).
41+
> Cmdlet reference articles follow a strict schema with limited formatting options, because the articles are also converted and used for help at the command line (`Get-Help <CmdletName>`). Use existing content as a guide. For more information, see [platyPS Schema](https://github.com/PowerShell/platyPS/blob/master/docs/developer/platyPS/platyPS.schema.md).
4242
4343
Select **Preview** to view your changes as you go. Select **Edit** to go back to making updates.
4444

4545
When you're finished making changes, select the green **Commit changes** button.
4646

47-
![Screenshot of how to select the green Commit changes button on the article editor page.](images/quick-update-editor-page.png)
47+
![Screenshot of how to select the green Commit changes button on the article editor page.](images/quick-update-04-github-editor-page.png)
4848

4949
7. In the **Propose changes** dialog that opens, review and/or enter the following values:
5050
- **Commit message**: This value is required. You can accept the default value ("Update \<filename\>") or you can change it.
@@ -54,37 +54,37 @@ Contributors who make infrequent or small updates can edit the file directly on
5454

5555
When you're finished on the **Propose changes** dialog, select the green **Propose changes** button.
5656

57-
![Screenshot of how to select the green Propose changes button in the Propose changes dialog.](images/quick-update-propose-changes-dialog.png)
57+
![Screenshot of how to select the green Propose changes button in the Propose changes dialog.](images/quick-update-05-propose-changes-dialog.png)
5858

5959
8. On the **Comparing changes** page that opens, select the green **Create pull request** button.
6060

61-
![Screenshot of how to select the green Create pull request button on the Comparing changes page.](images/quick-update-comparing-changes-page.png)
61+
![Screenshot of how to select the green Create pull request button on the Comparing changes page.](images/quick-update-06-comparing-changes-page.png)
6262

6363
9. On the **Open a pull request** page that opens, review the title and comments, and then select the green **Create pull request** button.
6464

65-
![Screenshot of how to select the green Create pull request button on the Open a pull request page.](images/quick-update-open-a-pull-request-page.png)
65+
![Screenshot of how to select the green Create pull request button on the Open a pull request page.](images/quick-update-07-open-a-pull-request-page.png)
6666

6767
10. That's it. There's nothing more for you to do.
6868

69-
The article owner (identified in metadata) is notified about the changes to the article. Eventually, the article owner or another party will review, possibly edit, and approve your changes. After your pull request is merged, the article is updated on learn.microsoft.com.
69+
The article owner (identified in metadata) is notified about the changes to the article. Eventually, the article owner or another party reviews, possibly edits, and approves your changes. After the reviewer merges your pull request, the article is updated on learn.microsoft.com.
7070

7171
## Microsoft Open Source Code of Conduct
7272

73-
This project has adopted the [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/).
73+
This project adopted the [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/).
7474

7575
For more information, see the [Code of Conduct FAQ](https://opensource.microsoft.com/codeofconduct/faq/) or contact [[email protected]](mailto:[email protected]) with any questions or comments.
7676

7777
### Contributing
7878

79-
This project welcomes contributions and suggestions. Most contributions require you to agree to a Contributor License Agreement (CLA) declaring that you have the right to, and actually do, grant us the rights to use your contribution. For details, visit <https://cla.microsoft.com>.
79+
This project welcomes contributions and suggestions. Most contributions require you to agree to a Contributor License Agreement (CLA) declaring that you have the right to, and actually do, grant us the rights to use your contribution. For details, visit <https://cla.microsoft.com>.
8080

8181
When you submit a pull request, a CLA-bot automatically determines whether you need to provide a CLA and decorate the PR appropriately (for example, label, comment). Follow the instructions provided by the bot. You only need to do this step once across all repos using our CLA.
8282

8383
### Legal Notices
8484

8585
Microsoft and any contributors grant you a license to the Microsoft documentation and other content in this repository under the [Creative Commons Attribution 4.0 International Public License](https://creativecommons.org/licenses/by/4.0/legalcode), see the [LICENSE](LICENSE) file, and grant you a license to any code in the repository under the [MIT License](https://opensource.org/licenses/MIT), see the [LICENSE-CODE](LICENSE-CODE) file.
8686

87-
Microsoft, Windows, Microsoft Azure and/or other Microsoft products and services referenced in the documentation may be either trademarks or registered trademarks of Microsoft in the United States and/or other countries/regions.
87+
Microsoft, Windows, Microsoft Azure and/or other Microsoft products and services referenced in the documentation might be either trademarks or registered trademarks of Microsoft in the United States and/or other countries/regions.
8888

8989
The licenses for this project don't grant you rights to use any Microsoft names, logos, or trademarks. Microsoft's general trademark guidelines can be found at <https://go.microsoft.com/fwlink/?LinkID=254653>.
9090

images/m365-cc-sc-edit-icon.png

-634 Bytes
Binary file not shown.
-94 KB
Binary file not shown.
139 KB
Loading
22 KB
Loading
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
87.3 KB
Loading

0 commit comments

Comments
 (0)