Haruskah repositori juga berfungsi sebagai situs web proyek (setidaknya untuk proyek kecil)?

Question

Ini adalah pertanyaan yang lebih filosofis, tetapi pertanyaan semacam itu diperbolehkan di sini.

Seperti yang kita semua tahu, ada berbagai host proyek gratis. Fitur umum untuk mungkin semuanya adalah kemampuan untuk menautkan atau bahkan mengelola situs web eksternal.

Pertanyaan saya adalah apakah menurut Anda sebenarnya ada kebutuhan akan situs web eksternal?

Tempat seperti GitHub memungkinkan pemilik proyek membuat wiki dengan tangkapan layar, dll. Namun demikian, tempat-tempat seperti infobox perangkat lunak Wikipedia memperlakukan GitHub seperti sebuah repositori sambil mengharapkan tautan resmi mengarah ke tempat lain.

Mengapa? Mungkin proyek besar tidak ingin bergantung pada pihak ketiga seperti GitHub, tapi bagaimana dengan proyek kecil?

Mengapa memiliki 2 situs web yang identik, keduanya dengan informasi yang sama persis, manual, dll. (Kecuali salah satunya disebut repositori)?

Apa yang harus lebih baik untuk pemasaran?

Dan haruskah Anda memilih situs web eksternal, haruskah Anda tidak menggunakan wiki repositori untuk menghindari duplikasi yang disebutkan di atas?

Answer 1

Untuk banyak proyek, README adalah semua yang dibutuhkan dalam situs web. Karena host repositori seperti GitHub atau Gitlab akan menampilkan README yang dirender dengan baik, situs web tidak akan menambahkan banyak. Ini adalah pendekatan umum untuk sebagian besar perangkat lunak open-ish.

Situs web terpisah (mungkin di domain Anda sendiri) lebih masuk akal ketika Anda ingin proyek memiliki identitas yang tidak terlalu bergantung pada layanan hosting sumber, atau jika Anda ingin menampilkan konten yang melampaui apa yang dapat dimasukkan secara wajar ke dalam README . Jadi intinya, pemasaran atau dokumen. Meskipun kode sumber untuk situs web mungkin merupakan bagian dari repositori kode sumber, keduanya tidak sama. Bahkan dalam bentuk yang dirender, file sumber tersebut tidak terlalu ramah manusia, misalnya tautan mungkin salah, atau GitHub mungkin tidak sepenuhnya memahami sintaksnya.

Namun, saya menyarankan Anda menjauh dari fitur Wiki GitHub. Sisi positifnya, halaman wiki mudah diedit. Tetapi dibandingkan dengan situs web yang sebenarnya, mereka sulit ditemukan, dan sangat terbatas dalam navigasi atau opsi tema. Sebagian besar penggunaan wiki GH yang baik tampaknya sebagai basis pengetahuan proyek atau sebagai semacam bahan penggaruk. Wiki ini tidak akan pernah berfungsi sebagai halaman arahan bagi pengguna, jadi Anda perlu menautkan wiki dari tempat lain (README dan / atau situs web).