Hacktoberfest e Microsoft Learn

Hacktoberfest è un evento annuale mondiale tenuto durante il mese di 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 . Alcuni dei repository partecipano attivamente all'evento Hacktoberfest. In questo articolo si apprenderà come individuare i repository che accettano richieste pull e cosa aspettarsi come collaboratore.

Trovare un repository

Per scoprire se un repository di Microsoft Learn partecipa a Hacktoberfest, verrà visualizzato l'argomento hacktoberfest sul progetto.

GitHub .NET docs repository with hacktoberfest topic.

Per filtrare tutti i repository di Microsoft Learn e .NET con l'argomento hacktoberfest , vedere GitHub Topics: Hacktoberfest.

In alternativa, un repository può scegliere di usare l'etichetta Hacktoberfest . Questa etichetta è utile per filtrare i problemi. Per altre informazioni, vedere Problemi di filtro e richieste pull in base alle etichette.

Suggerimento

Se sei un amministratore del repository e vuoi consentire al repository di partecipare a Hacktoberfest, aggiungi l'argomento hacktoberfest al repository. Per altre informazioni, vedere Classificazione del repository con argomenti.

Contribuisci

Per contribuire a un repository open source, è prima necessario configurare l'account per contribuire a Microsoft Learn. Se questo processo non è mai stato completato, iniziare eseguendo l'iscrizione a un account GitHub. È anche necessario registrare un profilo per tenere traccia delle attività. Vedi Hacktoberfest.

Dopo aver configurato l'account, iniziare leggendo e rispettando il file CONTRIBUTING.md nella radice del repository a cui si vuole contribuire. Questi file fungono da guida per contribuire. Ecco alcune guide di collaboratore di esempio di alcuni repository comuni di Microsoft Learn:

Oltre al file Markdown che contribuisce, se un repository ha un file CODE_OF_CONDUCT.md , è necessario rispettare il comportamento previsto nella community. Di nuovo, ecco alcuni esempi comuni:

Per altre informazioni, vedere Hacktoberfest: Partecipazione.

Scegliere un problema

Per trovare un problema da risolvere in un repository partecipante, filtrare i problemi per le up-for-grabs etichette o help-wanted GitHub. Anche se è possibile risolvere altri problemi, è più facile concentrarsi sui problemi che hanno un ambito ben definito e sono autonomi. Oltre ai repository di Microsoft Learn, è possibile usare i siti seguenti per principianti:

Per altre informazioni, vedere Hacktoberfest: Principianti.

Aspettative di qualità

Per avere un contributo positivo a un repository di Microsoft Learn open source, creare una richiesta pull significativa e interessata. Gli esempi seguenti del sito ufficiale Hacktoberfest sono considerati contributi di bassa qualità:

  • Richieste pull automatizzate, ad esempio l'apertura tramite script delle richieste pull per rimuovere spazi vuoti, correggere errori di digitazione o ottimizzare le immagini.
  • Richieste pull che causano interruzioni , ad esempio l'acquisizione di un ramo o commit di un altro utente e l'esecuzione di una richiesta pull.
  • Richieste pull considerate da un manutentore del progetto come un ostacolo rispetto all'aiuto.
  • Un invio che è chiaramente un tentativo di semplicemente +1 il conteggio delle richieste pull per ottobre.

Infine, una richiesta pull per correggere un errore di digitazione è buona, ma cinque richieste pull per rimuovere uno spazio vuoto randagio non sono.

Per altre informazioni, vedere Hacktoberfest: Values.For more information, see Hacktoberfest: Values.

Aprire una richiesta pull

Una richiesta pull offre un modo pratico per consentire a un collaboratore di proporre un set di modifiche. Quando si apre una richiesta pull, specificare nel commento originale che deve contribuire a hacktoberfest. Le richieste pull riuscite hanno queste caratteristiche comuni:

  • La richiesta pull aggiunge valore.
  • Il collaboratore è receptive al feedback.
  • I cambiamenti previsti sono ben articolati.
  • Le modifiche sono correlate a un problema esistente.

Se si propone una richiesta pull senza un problema corrispondente, creare prima un problema. Per altre informazioni, vedere GitHub: Informazioni sulle richieste pull.

Vedi anche