Skip to content
Merged
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
61 changes: 28 additions & 33 deletions reference/docs-conceptual/community/contributing/hackathons.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
---
description: This article describes how we manage and support hack-a-thon events like Hacktoberfest.
ms.date: 03/30/2025
ms.date: 05/29/2025
title: Hacktoberfest and other hack-a-thon events
---
# Hacktoberfest and other hack-a-thon events
Expand All @@ -16,30 +16,30 @@ Before you can contribute to an open source repo, you must first configure your
contribute to Microsoft Learn. If you're new to this process, start by signing up for a
[GitHub account][01]. Be sure to [install Git and the Markdown tools][02].

To get credit for participation, [register with Hacktoberfest][03] and read their
[participation guide][04].
To get credit for participation, register with [Hacktoberfest][14] and read their participation
guide.

## Find a repo that needs your help

The PowerShell-Docs team is supporting Hacktoberfest contributions for several PowerShell
documentation repositories. We defined a set of cleanup tasks designed to be simple for first time
contributors. Full information can be found in the [Hacktoberfest meta-issue][05].
contributors. Full information can be found in the [Hacktoberfest meta-issue][11].

To be successful with these tasks, you should:

- Have a general understanding of PowerShell syntax
- Have an understanding of [splatting][06]
- Be able to read and follow the [PowerShell-Docs style guide][07] and [Editorial checklist][08]
- Have an understanding of [splatting][04]
- Be able to read and follow the [PowerShell-Docs style guide][06] and [Editorial checklist][05]
- Have basic familiarity with Markdown

Before contributing should read the meta-issue. When you're ready to start, open a new issue using
the Hacktoberfest issue template by using one of the following links:
Before contributing should read the meta-issue. When you're ready to start, open a new Hacktoberfest
using one of the following links:

- [MicrosoftDocs/PowerShell-Docs][09]
- [MicrosoftDocs/PowerShell-Docs-DSC][10]
- [MicrosoftDocs/PowerShell-Docs-Modules][11]
- [MicrosoftDocs/windows-powershell-docs][12]
- [MicrosoftDocs/azure-docs-powershell][13]
- [MicrosoftDocs/PowerShell-Docs][12]
- [MicrosoftDocs/PowerShell-Docs-DSC][09]
- [MicrosoftDocs/PowerShell-Docs-Modules][10]
- [MicrosoftDocs/windows-powershell-docs][13]
- [MicrosoftDocs/azure-docs-powershell][08]

### Quality expectations

Expand All @@ -54,8 +54,6 @@ and impactful PR. The following examples from the official Hacktoberfest site ar
- PRs deemed a hindrance vs. helping
- PRs that are clearly an attempt to increment your PR count for October

For more information, see [Hacktoberfest: Values][14].

### Open a PR

A _PR_ provides a convenient way for a contributor to propose a set of changes. Successful PRs have
Expand All @@ -67,28 +65,25 @@ these common characteristics:
- The changes are related to an existing issue.

If you're proposing a PR without a corresponding issue, create an issue first. For more information,
see [GitHub: About pull requests][15].
see [GitHub: About pull requests][07].

## See also

- [Git and GitHub essentials for Microsoft Learn documentation][16]
- [Official Hacktoberfest site][17]
- [Git and GitHub essentials for Microsoft Learn documentation][03]
- [Official Hacktoberfest site][14]

<!-- link references -->
[01]: /contribute/get-started-setup-github
[02]: /contribute/get-started-setup-tools
[03]: https://hacktoberfest.com/auth/
[04]: https://hacktoberfest.com/participation/
[05]: https://github.com/MicrosoftDocs/PowerShell-Docs/issues/9257
[06]: /powershell/module/microsoft.powershell.core/about/about_splatting
[07]: /powershell/scripting/community/contributing/powershell-style-guide
[08]: /powershell/scripting/community/contributing/editorial-checklist
[09]: https://github.com/MicrosoftDocs/PowerShell-Docs/issues/new?assignees=&labels=&template=00-hacktoberfest.yml&title=%F0%9F%8E%83+2022%3A+
[10]: https://github.com/MicrosoftDocs/PowerShell-Docs-DSC/issues/new?assignees=&labels=&template=00-hacktoberfest.yml&title=%F0%9F%8E%83+2022%3A+
[11]: https://github.com/MicrosoftDocs/PowerShell-Docs-Modules/issues/new?assignees=&labels=&template=00-hacktoberfest.yml&title=%F0%9F%8E%83+2022%3A+
[12]: https://github.com/MicrosoftDocs/windows-powershell-docs/issues/new?assignees=&labels=&template=00-hacktoberfest.yml&title=%F0%9F%8E%83+2022%3A+
[13]: https://github.com/MicrosoftDocs/azure-docs-powershell/issues/new?assignees=&labels=&template=00-hacktoberfest.yml&title=%F0%9F%8E%83+2022%3A+
[14]: https://hacktoberfest.com/participation/#values
[15]: https://docs.github.com/github/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/about-pull-requests
[16]: /contribute/git-github-fundamentals
[17]: https://hacktoberfest.com/
[03]: /contribute/git-github-fundamentals
[04]: /powershell/module/microsoft.powershell.core/about/about_splatting
[05]: /powershell/scripting/community/contributing/editorial-checklist
[06]: /powershell/scripting/community/contributing/powershell-style-guide
[07]: https://docs.github.com/github/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/about-pull-requests
[08]: https://github.com/MicrosoftDocs/azure-docs-powershell/issues/new?assignees=&labels=&template=00-hacktoberfest.yml&title=%F0%9F%8E%83+2022%3A+
[09]: https://github.com/MicrosoftDocs/PowerShell-Docs-DSC/issues/new?assignees=&labels=&template=00-hacktoberfest.yml&title=%F0%9F%8E%83+2022%3A+
[10]: https://github.com/MicrosoftDocs/PowerShell-Docs-Modules/issues/new?assignees=&labels=&template=00-hacktoberfest.yml&title=%F0%9F%8E%83+2022%3A+
[11]: https://github.com/MicrosoftDocs/PowerShell-Docs/issues/9257
[12]: https://github.com/MicrosoftDocs/PowerShell-Docs/issues/new?assignees=&labels=&template=00-hacktoberfest.yml&title=%F0%9F%8E%83+2022%3A+
[13]: https://github.com/MicrosoftDocs/windows-powershell-docs/issues/new?assignees=&labels=&template=00-hacktoberfest.yml&title=%F0%9F%8E%83+2022%3A+
[14]: https://hacktoberfest.com/