Nota
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare ad accedere o modificare le directory.
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare a modificare le directory.
Hacktoberfest è un evento annuale in tutto il mondo che si tiene durante ottobre. L'evento incoraggia gli sviluppatori open source a contribuire ai repository tramite richieste pull. GitHub ospita molti repository open source che contribuiscono al contenuto di Microsoft Learn. Diversi repository partecipano attivamente a Hacktoberfest.
Come contribuire
Prima di poter contribuire a un repository open source, è necessario configurare l'account per contribuire a Microsoft Learn. Se non si ha familiarità con questo processo, iniziare eseguendo l'iscrizione a un account GitHub. Assicurarsi di installare Git e gli strumenti Markdown.
Per ottenere il credito per la partecipazione, registrarsi con Hacktoberfest e leggere la guida alla partecipazione.
Trovare un repository che richiede assistenza
Il team PowerShell-Docs supporta i contributi per Hacktoberfest per diversi repository di documentazione di PowerShell. È stato definito un set di attività di pulizia progettate per essere semplici per i collaboratori per la prima volta. Le informazioni complete sono disponibili nel meta-problema Hacktoberfest.
Per avere esito positivo con queste attività, è necessario:
- Conoscenza generale della sintassi di PowerShell
- Avere una comprensione dello splatting
- Essere in grado di leggere e seguire la guida di stilePowerShell-Docs e l'elenco di controllo editoriale
- Acquisire familiarità di base con Markdown
Prima di contribuire, leggere il meta-problema. Quando si è pronti per iniziare, aprire un nuovo Hacktoberfest usando uno dei collegamenti seguenti:
- MicrosoftDocs/PowerShell-Docs
- MicrosoftDocs/PowerShell-Docs-DSC
- MicrosoftDocs/PowerShell-Docs-Modules
- MicrosoftDocs/windows-powershell-docs
- MicrosoftDocs/azure-docs-powershell
Aspettative di qualità
Per contribuire con successo a un repository open source di Microsoft Learn, creare una richiesta pull significativa e d'impatto. Gli esempi seguenti del sito ufficiale Hacktoberfest sono considerati contributi di bassa qualità:
- Pull request contenenti modifiche automatizzate su larga scala
- Esempio: script di pull request per rimuovere spazi vuoti, correggere errori ortografici comuni o ottimizzare le immagini
- Inviare un problema descrivendo prima le modifiche automatizzate che si desidera apportare
- Richieste di pull considerate di disturbo (ad esempio, appropriarsi del ramo o dei commit di qualcun altro e effettuare una richiesta di pull)
- Le richieste pull hanno considerato un ostacolo rispetto all'aiuto
- Richieste pull che sono chiaramente un tentativo di incrementare il numero di richieste pull per ottobre
Aprire una richiesta pull
Una PR offre un modo pratico per un collaboratore di proporre un set di modifiche. Le pull request riuscite hanno queste caratteristiche comuni:
- La richiesta pull aggiunge valore.
- Il collaboratore è ricettivo al feedback.
- I cambiamenti previsti sono ben articolati.
- Le modifiche sono correlate a un problema esistente.
Se stai proponendo una pull request senza una issue corrispondente, crea prima un'issue. Per altre informazioni, vedere GitHub: Informazioni sulle richieste pull.