Contenuto del file AUTHORS

Question

Contenuto del file AUTHORS

#1 da (6 voti)
#2 da (2 voti)

4

GNU raccomanda di creare un file AUTHORS per elencare gli autori e i contributori di un programma. Ma quanti "livelli" di autori e contributori dovrebbero contenere il file? Per esempio. se scrivo un programma foo che utilizza attivamente alcune librerie, dovrei includere gli autori di quella libreria nel file AUTHORS ? Sembra che la risposta sia "sì", perché il codice totale di foo contiene il codice della libreria. Ma se sì, ciò significa che dovrei includere anche gli autori di tutte le altre librerie, incluse le librerie standard del compilatore, gli autori del compilatore e altri strumenti per produrre il codice eseguibile finale, gli autori del sistema operativo ... Quando dovrei smettere?

open-source documentation contribution

posta Jeremy Heiler 04.06.2012 - 17:15

fonte

2 risposte

2

Gli autori delle dipendenze delle tue librerie non sono autori del tuo progetto. Come hai sottolineato, non presumendo che possa sfuggire al controllo. Solitamente si elencano solo le persone che hanno contribuito con qualcosa direttamente al progetto, in particolare codice e documentazione. Se, tuttavia, una particolare dipendenza o persona ha influenzato in modo significativo il tuo progetto, potrebbe essere opportuno avere una sezione "ringraziamenti speciali" che identifichi quei progetti, comunità o persone.

Fammi usare GitHub come esempio. Ogni progetto ha una lista di "contributori" generata automaticamente. Come decidono chi è in quella lista? Non sono esattamente sicuro, ma sembra che chiunque abbia effettuato il commit di un commit nel repository.

risposta data 04.06.2012 - 17:21

fonte

Leggi altre domande sui tag open-source documentation contribution

Iniezione delle dipendenze e contenitori IOC in un progetto chiuso I metodi statici impliciti possono causare problemi?

score 6 · Accepted Answer

Mi sembra ragionevole ritenere che il progetto di dipendenza debba avere il proprio file AUTHORS e che l'intero processo si riduca in modo ricorsivo. Sei responsabile per l'identificazione degli autori per il codice che hai scritto. Gli autori delle altre librerie dovrebbero essere già menzionati nel file AUTHORS di ogni lib.