Convenzione Github per mettere in attesa i progetti

1

Ho alcuni progetti github in movimento contemporaneamente.

Sto solo lavorando attivamente su uno alla volta che può richiedere mesi. I miei altri progetti rimangono in uno stato semi-completato. Esiste una convenzione per sviluppatori per indicare che un progetto è in attesa? Cioè nessuno sviluppo attivo?

    
posta Faktor 10 03.03.2015 - 22:01
fonte

2 risposte

2

Se il progetto non è utilizzabile nella sua forma attuale, dì qualcosa in quella misura vicino all'inizio del README. Non deve essere un grassetto tutto maiuscolo "Non usare", ma dovrebbe essere evidente a un idiota di fretta per salvare il tempo di tutti.

Se il progetto è utilizzabile ma in uno stato terribile, dovresti probabilmente dire in termini piuttosto chiari che non stai mantenendo il progetto e (se vuoi essere gentile) suggerire alternative per le persone che stanno usando il progetto o vorrebbe usare il progetto. Se il progetto è registrato su repository di gestori di pacchetti come NPM, RubyGems, PyPI, ecc, probabilmente è anche una buona forma pubblicare "un ultimo aggiornamento" per aggiornare la descrizione, ma non lasciare che il pacchetto emetta ulteriore output della console a meno che l'utente puoi disabilitarlo.

Se il progetto è utilizzabile ma è necessario prendere una pausa, chiarire eventuali problemi aperti. È bello sapere che un progetto non è attivamente mantenuto al momento ma non è morto, perché altrimenti potresti non pensare di avere un altro aspetto quando il manutentore riprende il loro lavoro (o un nuovo manutentore ha preso il sopravvento). Fai questo anche se stai cercando manutentori: se qualcuno ha avuto difficoltà a creare un PR o a sollevare un problema, potrebbe essere interessato a contribuire ulteriormente o almeno a raccontare agli altri.

Inoltre, se ci sono molti repository attivi e molti inattivi che ingombrano il tuo account e trovi che quelli inattivi sono troppo distratti, potresti creare un'organizzazione GitHub e spostare lì i progetti incompleti / esplorativi. Non sarà un indicatore ovvio per gli altri, ma potresti trovarlo rassicurante. Potrei aver esagerato con questo (ho anche spostato tutte le mie forcelle one-off in un'org separata), ma penso che sia più umano che cancellare solo i progetti abbandonati.

    
risposta data 03.03.2015 - 22:37
fonte
0

Potresti sempre aggiornare il file Leggimi (dato che presumo che la maggior parte delle persone lo vedranno nella pagina Github principale per il tuo progetto).

Direi che continui a fare quello che stai facendo. Lavora su un altro progetto e torna a questo quando sei pronto. Forse qualcuno biforcherà e contribuirà in tua assenza. Chissà, questa è la bellezza dell'open source. Il tuo timestamp per il check in revisioni dovrebbe indicare a tutti coloro che non controllano il tuo file che sei occupato altrove.

    
risposta data 03.03.2015 - 22:11
fonte

Leggi altre domande sui tag