it-swarm.dev

Come posso contribuire con il codice a Joomla?

Sono consapevole che il codice è gestito su https://github.com/joomla/joomla-cms (almeno per il CMS) e che dovrei inviare richieste pull per suggerire che il codice debba essere aggiunto.

Sono particolarmente interessato a tutti i buoni consigli sulla gestione dei miei contributi e sull'assicurazione che il codice arrivi nel posto giusto.

Dovrei usare diverse filiali nel mio repository con fork per gestire contributi diversi? In tal caso, qual è il modo migliore per collegare quel ramo ai rami principali nel repository Joomla?

Esiste un buon metodo per mantenere aggiornata la mia copia a forcella?

Qualsiasi suggerimento su un buon flusso per la gestione di questo processo sarebbe davvero utile!

19
David Fritsch

È sempre utile avere una filiale dedicata per ogni richiesta pull che stai per fare.

Uno dei modi più semplici per creare un nuovo ramo aggiornato è utilizzare semplicemente la GUI Web di GitHub per modificare il file nel repository originale. Durante il salvataggio, GitHub creerà automaticamente un nuovo ramo nel fork in base al ramo attualmente modificato. Se vuoi modificare più file, puoi modificarli nel tuo ramo appena creato e aggiornato.

Se hai un po 'di familiarità con Git, allora ridimensiona il ramo di gestione temporanea a forcella con il ramo originale a monte, quindi è sincronizzato prima di creare nuovi rami. Inoltre, se è necessario aggiornare un PR, si consiglia di riformularlo anziché unire master. Mentre funzionano in entrambi i modi, i merge-commit stanno solo creando una brutta storia e sono più difficili da eliminare.

In generale, i PR dovrebbero essere "atomici". Questo significa che se provi a riparare qualcosa, correggi solo quel particolare bug. Non correggere due diversi bug nella stessa PR e non eseguire correzioni di codestyle. È più facile testare e anche meno probabilità di creare conflitti se il PR vive un po 'più a lungo del previsto.

E ovviamente aggiungi una buona descrizione di ciò che vuoi fare e istruzioni di test per riprodurre il problema e testare la tua correzione :-)

10
Bakual

Una cosa importante che aiuta a raggruppare i tuoi contributi è di spostare ciascun contributo in un ramo separato, opportunamente denominato. Se stai aggiungendo una funzione, utilizza un prefisso come feature- e aggiungere una o due parole per la descrizione della parola per il nome del ramo. Se si tratta di una correzione di bug nella classe JForm, usa bugfix-jform. Questo rende davvero facile identificare a cosa stai lavorando controllando i tuoi rami git tramite git branch -a.

4
Don Gilbert