Ho avviato un progetto che coinvolge almeno tre repository su GitHub.
Uno dei repository è un dump generico di documentazione ed esempi e gli altri due contengono l'implementazione di due programmi che costituiscono la struttura portante del progetto.
Dovrei usare un'organizzazione GitHub per gestire tale configurazione?
O dovrei semplicemente scaricare tutto sul mio conto, insieme a una dozzina di altri repository completamente indipendenti?
Risposte:
Inizia con i repository nel tuo account personale. Da lì, se / quando le cose crescono e / o diventano popolari con la comunità, spostale su un account dell'organizzazione.
Diamo un'occhiata ad alcune delle tue opzioni:
Per ulteriori informazioni sulle funzionalità dell'organizzazione GitHub, assicurarsi di leggere:
Blog di GitHub: Presentazione delle organizzazioni
Se hai mai dovuto gestire più account GitHub, desiderato una dashboard specifica per l'azienda, volevi aggiungere collaboratori di sola lettura o hai bisogno di dare a qualcun altro il controllo amministrativo su uno dei tuoi repository, adorerai le organizzazioni.
Sulla base della tua domanda, non posso dire se un'organizzazione è giusta per te (il mio istinto mi sta dicendo "no") , ma forse guardare alcuni esempi del mondo reale ti aiuterà a prendere la tua decisione.
Ecco alcuni esempi di organizzazioni GitHub che trovo interessanti da guardare:
https://github.com/gruntjs
Questo è uno dei miei esempi preferiti di un account Organizzazione open source. Sono per lo più colpito dalle convenzioni di denominazione utilizzate per i repository (vale a dire, essenzialmente grunt/è il repository principale e tutti i relativi core / contrib code / plugin / attività vivono nei grunt-xxxx/repository).
https://github.com/github
Probabilmente vale la pena guardare la propria organizzazione di GitHub. account. Le convenzioni di denominazione utilizzate per i repository non sono rigide come quelle di Grunt (IMHO), ma è comunque un buon esempio. Oh, e ora è probabilmente un momento decente per sottolineare la scheda "Membri" , dato che non si ottiene questo per account personali o repository.
https://github.com/twbs
Bootstrap di Twitter. Penso che questo sia un buon esempio di organizzazione. conto con solo pochi repository (notare il singolo repository con oltre 58.000 stelle). Si noti inoltre che Bootstrap ha cinque membri (al momento della stesura di questo), ma quei cinque sono responsabili di un repository follemente popolare (al contrario di quello dei 214 membri dell'organizzazione GitHub ).
Alcuni esempi più generali:
https://github.com/yeoman : strumenti di creazione.
https://github.com/h5bp : HTML5 boilerplate.
https://github.com/nprapps : esempio di industria delle notizie.
Come già accennato, è possibile creare repository all'interno del proprio account personale e passare da lì.
Avrai bisogno di collaboratori?
Guida di GitHub: Collaborazione / Come posso aggiungere un collaboratore?
Come puoi vedere, aggiungere collaboratori è abbastanza indolore.
Sulla base della tua domanda, questa opzione suona come quella che desideri.
È possibile creare un repository e utilizzare i rami per organizzare i relativi bit di codice.
Non credo che la maggior parte delle persone concorderebbe sul fatto che questo è il modo migliore per organizzare il tuo codice :
D'altra parte, non c'è nulla che dica che non è possibile organizzare parti di codice correlate usando i rami.
Un fastidio personale che ho con questa tecnica è che l'interfaccia grafica / interfaccia di GitHub mostrerà questo messaggio:
... quando si visualizzano filiali diverse dalla propria master(vale a dire, se la propria filiale è avanti / indietro nelle commit).
Suggerimento: se stai utilizzando una versione più recente di Git, puoi estrarre rami specifici usando git clone -b mybranch --single-branch git://sub.domain.com/repo.git:
Relazionato:
Dovrei usare un'organizzazione GitHub per gestire tale configurazione? O dovrei semplicemente scaricare tutto sul mio conto, insieme a una dozzina di altri repository completamente indipendenti?
È possibile utilizzare una combinazione di tutto quanto sopra. Per esempio:
Installa un'organizzazione per "... dump di documentazione ed esempi generici e gli altri due contengono l'implementazione di due programmi che formano la struttura portante del progetto".
Usa il tuo account personale per "... una dozzina di altri repository completamente indipendenti"
Utilizzare le filiali per pagine dimostrative gh-pages, codice correlato e / o documentazione.
Vale anche la pena ricordare che è possibile utilizzare la WIKI di un repository a scopo di documentazione: