Poznámka:
Přístup k této stránce vyžaduje autorizaci. Můžete se zkusit přihlásit nebo změnit adresáře.
Přístup k této stránce vyžaduje autorizaci. Můžete zkusit změnit adresáře.
Hacktoberfest je každoroční celosvětová akce, která se koná v říjnu. Tato událost podporuje open-source vývojáře, aby přispěli do úložišť prostřednictvím PR (pull requestů). GitHub hostuje mnoho opensourcových úložišť, která přispívají k obsahu Microsoft Learn. Několik úložišť se aktivně účastní Hacktoberfestu.
Jak přispívat
Než budete moct přispívat do opensourcového úložiště, musíte nejprve nakonfigurovat svůj účet tak, aby přispěl do Microsoft Learn. Pokud s tímto procesem začínáte, začněte registrací účtu GitHub. Nezapomeňte nainstalovat Git a nástroje Markdownu.
Pokud chcete získat kredit za účast, zaregistrujte se u Hacktoberfestu a přečtěte si průvodce účastí.
Najděte úložiště, které potřebuje vaši pomoc
Tým PowerShell-Docs podporuje příspěvky Hacktoberfestu pro několik úložišť dokumentace k PowerShellu. Definovali jsme sadu úloh čištění, které jsou navržené tak, aby byly jednoduché pro přispěvatele poprvé. Úplné informace najdete v meta-události Hacktoberfest.
Pokud chcete být úspěšní s těmito úlohami, měli byste:
- Obecné znalosti syntaxe PowerShellu
- Znalost splattingu
- Být schopen číst a řídit se příručkou styluPowerShell-Docs a Redakční kontrolní seznam
- Základní znalost Markdownu
Před přispěním byste si měli přečíst metazáležitost. Až budete připraveni začít, otevřete nový Hacktoberfest pomocí jednoho z následujících odkazů:
- MicrosoftDocs/PowerShell-Docs
- MicrosoftDocs/PowerShell-Docs-DSC
- MicrosoftDocs/PowerShell-Docs-Modules
- MicrosoftDocs/windows-powershell-docs
- MicrosoftDocs/azure-docs-powershell
Očekávání kvality
Chcete-li mít úspěšný příspěvek do open source úložiště Microsoft Learn, vytvořte smysluplnou a působivou žádost o přijetí změn (PR). Následující příklady z oficiálního webu Hacktoberfest jsou považovány za příspěvky nízké kvality:
- Žádosti o sloučení obsahující hromadné automatizované změny
- Příklad: Skriptované PRy pro odebrání mezer, opravu běžného pravopisu nebo optimalizaci obrázků
- Odešlete nejprve problém s popisem automatizovaných změn, které chcete provést.
- PR považované za rušivé (například převzetí větve nebo potvrzení někoho jiného a vytvoření PR)
- Žádosti o přijetí změn (pull requesty) považovány za překážku vs. pomocníka.
- Žádosti o přijetí změn, které se jasně snaží zvýšit počet žádostí o přijetí změn za říjen
Otevřít PR
Žádost o přijetí změn poskytuje pohodlný způsob, jak přispěvateli navrhnout sadu změn. Úspěšné žádosti o přijetí změn mají tyto společné charakteristiky:
- Žádost o přijetí změn přidává hodnotu.
- Přispěvatel má přístup ke zpětné vazbě.
- Zamýšlené změny jsou dobře vyjádřeny.
- Změny souvisejí s existujícím problémem.
Pokud navrhujete PR bez odpovídajícího úkolu, nejprve vytvořte úkol. Další informace najdete na stránce GitHub: O žádostech o přijetí změn.