Ho esaminato molti repository di software open source e ho trovato alcuni elementi comuni e cose simili che le persone fanno in modo diverso l'una dall'altra.
Ad esempio, ogni repository ha un file README
, un file INSTALL
, un file COPYING
e cose del genere.
Altre cose sono diverse:
- Alcuni progetti, come git, hanno il loro codice sorgente nel livello root, mentre altri hanno il codice sorgente in una cartella
src/
e altri, come il kernel Linux, hanno il codice sorgente diffuso in diverse cartelle a livello di root, che dividono il codice per aree; - Alcuni hanno i loro test in una cartella
t/
, mentre altri in una cartellatests/
, o altrimenti nominati; - Alcuni hanno file sull'invio delle patch e chi sono i manutentori, e quelli potrebbero trovarsi all'interno di qualche
Documentation/
o nel livello root.
Ci sono raccomandazioni? Una buona pratica?
Ad esempio: personalmente, non mi piace il codice nel livello root, git-fashion. Sembra disordinato e confonde uno che cerca di iniziare come contributore (specialmente perché hanno del codice all'interno delle cartelle e anche gli script a livello di root, è davvero disordinato).
Se dovessi iniziare un mio progetto e volessi iniziare sin dall'inizio, ci sono dei consigli? Migliori pratiche? Come posso creare una struttura chiara e pulita?
Grazie!