Come posso contribuire con il codice a Joomla?


19

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 di aggiungere il codice.

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 biforcato per gestire diversi contributi? In tal caso, qual è il modo migliore per ricollegare 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!

Risposte:


10

È sempre utile disporre di una filiale dedicata per ogni richiesta pull che si intende 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 :-)


4

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, usa un prefisso simile feature-e aggiungi una descrizione di una o due parole per il nome del ramo. Se si tratta di una correzione di bug nella JFormclasse, utilizzare bugfix-jform. Questo rende davvero facile identificare a cosa stai lavorando controllando i tuoi rami git tramite git branch -a.

Utilizzando il nostro sito, riconosci di aver letto e compreso le nostre Informativa sui cookie e Informativa sulla privacy.
Licensed under cc by-sa 3.0 with attribution required.