Organisasi GitHub untuk proyek yang mencakup banyak repositori?

11

Saya sudah memulai proyek yang melibatkan setidaknya tiga repositori di GitHub.

Salah satu repositori adalah dump dokumentasi-dan-contoh umum, dan dua lainnya berisi implementasi dua program yang membentuk tulang punggung proyek.

Haruskah saya menggunakan Organisasi GitHub untuk menangani konfigurasi seperti itu?
Atau haruskah saya membuang semuanya ke akun saya sendiri, bersama selusin repositori lain yang sama sekali tidak terkait?

git github organization repository jcora
sumber

Jawaban:

14

Jawaban singkat ...

Mulailah dengan repositori di akun pribadi Anda. Dari sana, jika / ketika segalanya tumbuh dan / atau menjadi populer di komunitas, pindahkan ke akun organisasi.

Jawaban panjang ...

Mari kita lihat beberapa opsi Anda:

1. Organisasi:

Untuk informasi lebih lanjut tentang fitur-fitur Organisasi GitHub, pastikan untuk membaca:

Blog GitHub: Organisasi Pengantar

Jika Anda pernah harus mengelola beberapa akun GitHub, menginginkan dasbor khusus perusahaan, ingin menambahkan kolaborator baca-saja, atau perlu memberi orang lain kontrol administratif atas salah satu repositori Anda, Anda akan menyukai Organisasi.

Berdasarkan pertanyaan Anda, saya tidak bisa mengatakan apakah suatu Organisasi tepat untuk Anda (naluri saya mengatakan "tidak") , tetapi mungkin dengan melihat beberapa contoh dunia nyata akan membantu Anda membuat keputusan.

Berikut adalah beberapa contoh Organisasi GitHub yang menurut saya menarik untuk dilihat:

  1. https://github.com/gruntjs
    Ini adalah salah satu contoh favorit saya dari akun Organisasi sumber terbuka. Saya sebagian besar terkesan dengan konvensi penamaan yang digunakan untuk repositori (yaitu, pada dasarnya grunt/adalah repo utama dan semua inti / kode contrib terkait / plugin / tugas tinggal di grunt-xxxx/repositori).

  2. https://github.com/github
    Mungkin perlu melihat Org milik GitHub. Akun. Konvensi penamaan yang digunakan untuk repositori tidak seketat Grunt's (IMHO), tetapi ini adalah contoh yang bagus. Oh, dan sekarang mungkin waktu yang tepat untuk menunjukkan tab "Anggota" , karena Anda tidak mendapatkan ini untuk akun pribadi atau repositori.

  3. https://github.com/twbs
    Twitter Bootstrap. Saya pikir ini adalah contoh yang baik dari Organisasi. akun dengan hanya beberapa repositori (perhatikan repo tunggal dengan 58.000 bintang). Perhatikan juga bahwa Bootstrap memiliki lima anggota (pada saat penulisan ini), namun kelima itu bertanggung jawab atas repositori yang sangat populer ( berbeda dengan 214 anggota Organisasi GitHub ).

    1. https://github.com/twitter : akun GitHub utama Twitter.

Beberapa contoh yang lebih umum:

  1. https://github.com/yeoman : Alat Bangun.

  2. https://github.com/h5bp : HTML5 boilerplate.

  3. https://github.com/nprapps : Contoh industri berita.

2. Akun pribadi

Seperti yang telah Anda sebutkan, Anda dapat membuat repositori di dalam akun pribadi Anda dan pergi dari sana.

Apakah Anda memerlukan kolaborator?

Bantuan GitHub: Berkolaborasi / Bagaimana cara menambahkan kolaborator?

Seperti yang Anda lihat, menambahkan kolaborator cukup menyakitkan.

Berdasarkan pertanyaan Anda, opsi ini terdengar seperti yang Anda inginkan.

3. Repo dengan banyak cabang:

Anda bisa membuat satu repositori dan menggunakan cabang untuk mengatur bit kode terkait Anda.

Saya tidak berpikir kebanyakan orang akan setuju bahwa ini adalah cara terbaik untuk mengatur kode Anda :

Di sisi lain, tidak ada yang mengatakan Anda tidak bisa mengatur bit kode terkait menggunakan cabang.

Satu gangguan pribadi yang saya miliki dengan teknik ini adalah bahwa GUI / antarmuka GitHub akan menampilkan pesan ini kepada Anda:

masukkan deskripsi gambar di sini

... saat melihat cabang selain dari Anda master(yaitu, jika cabang Anda berada di depan / belakang dalam komitmen).

Kiat: Jika Anda menggunakan versi Git yang lebih baru, Anda dapat menarik cabang tertentu menggunakan git clone -b mybranch --single-branch git://sub.domain.com/repo.git:

Terkait:

4. Pendekatan hybrid:

Haruskah saya menggunakan Organisasi GitHub untuk menangani konfigurasi seperti itu? Atau haruskah saya membuang semuanya ke akun saya sendiri, bersama selusin repositori lain yang sama sekali tidak terkait?

Anda dapat menggunakan kombinasi dari semua hal di atas. Sebagai contoh:

  1. Menyiapkan Organisasi untuk "... dump dokumentasi dan contoh umum, dan dua lainnya berisi implementasi dua program yang membentuk tulang punggung proyek".

  2. Gunakan akun pribadi Anda untuk "... selusin repositori lain yang sama sekali tidak berhubungan"

  3. Gunakan cabang untuk halaman demo gh-pages, kode terkait dan / atau dokumentasi.

Catatan:

Perlu juga disebutkan bahwa Anda dapat menggunakan WIKI repositori untuk keperluan dokumentasi:

mhulse
sumber