Come contribuire

Ci piacerebbe accettare le tue patch e i tuoi contributi a questo progetto. Basta seguire solo alcune piccole linee guida.

Contratto di licenza di collaboratore

I contributi a qualsiasi progetto Google devono essere accompagnati da un Contratto di licenza per collaboratori. Non si tratta di un'assegnazione relativa al copyright, ma autorizza semplicemente Google a utilizzare e ridistribuire i tuoi contributi nell'ambito del progetto.

In genere è sufficiente inviare un CLA una sola volta, quindi se ne hai già inviato uno (anche se era per un altro progetto), probabilmente non sarà necessario farlo di nuovo.

Invio di una patch

  1. È generalmente meglio iniziare aprendo un nuovo problema per descrivere il bug o la funzionalità che desideri correggere. Anche se pensi che sia relativamente minore, è utile sapere a cosa stanno lavorando le persone. Indica nel problema iniziale che hai intenzione di lavorare a quel bug o a quella funzionalità in modo che possa essere assegnata a te.

  2. Segui la normale procedura di fork del progetto e configura un nuovo ramo in cui lavorare. È importante che ogni gruppo di modifiche venga eseguito in rami separati per garantire che una richiesta di pull includa solo i commit relativi al bug o alla funzionalità in questione.

  3. Eventuali modifiche significative dovrebbero quasi sempre essere accompagnate da test. Il progetto ha già una buona copertura dei test, quindi dai un'occhiata ad alcuni dei test esistenti se non sai bene come procedere.

  4. Fai del tuo meglio per avere messaggi di commit corretti per ogni modifica. Ciò garantisce coerenza in tutto il progetto e garantisce che i messaggi di commit possano essere formattati correttamente da vari strumenti Git.

  5. Infine, spingi i commit sulla forchetta e invia una richiesta di pull.