Bahan ini awalnya diposting di Habr.com dalam bahasa Rusia. Penulis mengizinkannya untuk diterjemahkan dan dipublikasikan di Codingsight.
Mungkin, setiap orang memiliki suatu tempat file untuk menyimpan hal-hal tertentu yang menarik dan berguna, seperti, link ke artikel, buku, repositori, manual, dll Anda mungkin menggunakan bookmark di browser atau tab, masih terbuka dan menunggu Anda. Seiring waktu, semuanya tumbuh berlebihan, tautan menjadi rusak, dan materi menjadi usang.
Tetapi bagaimana jika kita dapat membagikan permata yang berwawasan luas ini kepada komunitas? Unggah file ke GitHub? Kemudian, temuan Anda akan berguna bagi orang lain. Selain itu, akan lebih mudah untuk menjaga agar file tetap mutakhir, memperbarui daftar melalui pull request lama yang bagus.
Inilah tujuan kami memiliki proyek Awesome Lists.
Awesome Lists adalah salah satu dari 10 repositori GitHub teratas, yang sudah memiliki 138 ribu “bintang”, dan tautan ke karya Anda dapat membuatnya menjadi README root, sehingga menarik banyak audiens. Namun, Anda harus berusaha terlebih dahulu. Di sini, saya ingin berbagi pengalaman.
Saya Maksim Gramin, seorang pengembang Java dan peneliti basis data di CROC, sebuah perusahaan IT internasional dengan kantor pusat di Moskow. Artikel ini akan memberi tahu Anda tentang Daftar Luar Biasa dan cara membuat repo keren resmi Anda.
Tentang Apa Daftar Keren Itu?
Setiap kali saya harus berurusan dengan beberapa teknologi baru atau bahasa pemrograman, saya pergi ke sana terlebih dahulu, mencari bagian yang diperlukan dan daftar yang sesuai. Mengingat jumlah “bintang” yang besar dan terus meningkat, saya bukan satu-satunya orang dengan pendekatan seperti itu.
Faktanya, "Daftar Luar Biasa" adalah readme.md biasa yang tinggal di repositori terpisah. Namun, ia menempati posisi 8 di antara semua repositori GitHub dan termasuk daftar lain yang didedikasikan untuk topik tertentu. Misalnya, bagian Bahasa Pemrograman memiliki daftar Awesome Python dan Awesome Go, sedangkan bagian Pengembangan Front-End menyimpan banyak materi pengembangan Web. Last but not least, ada bagian Database (kita akan membicarakannya nanti).
Tentu saja, kontennya tidak terbatas pada mata pelajaran teknis saja dan juga mencakup bagian lain, seperti Hiburan dan Permainan. Anda juga dapat menemukan banyak hal menarik di sana (saya sangat senang dengan daftar fantasi yang luar biasa).
Perbedaan utama proyek ini adalah bahwa semua daftar ini tidak hanya dikelola oleh penulis, tetapi juga oleh komunitas. Selain itu, semuanya dibuat sesuai dengan Awesome Manifesto yang ketat. Setiap daftar mewakili komunitas spesialis yang terpisah, menjalani kehidupannya sendiri dan terbuka untuk permintaan tarik Anda, yang akan membuatnya lebih baik. Selain itu, siapa pun dapat membuat daftar mereka sendiri jika ada topik yang kurang dieksplorasi.
Untuk ide orisinal dan koordinasi semua hal ini, kami harus berterima kasih kepada Sindre Sorhus yang legendaris, orang pertama di GitHub dan penulis 1.000+ modul npm. Dialah yang akan menerima permintaan tarik Anda.
Cara Membuat Daftar Keren
Jika Anda belum menemukan daftar yang tepat untuk topik yang diperlukan, itu adalah tanda pertama bahwa Anda harus melakukannya sendiri! Saya akan memberi tahu Anda cara melakukannya dengan contoh kreasi saya sendiri – Alat Basis Data Luar Biasa.
Proyek demi proyek, saya harus berurusan dengan semua jenis database. Jadi, saya mulai mengelola beberapa file tempat saya mengumpulkan berbagai alat bantu untuk bekerja. Ada berbagai DB-migrators, IDE, panel admin, alat pemantauan, dll., termasuk yang sudah saya gunakan atau baru saja saya rencanakan.
Saya membagikan file ini dengan rekan-rekan saya di CROC dan di luarnya, terdorong dengan melihat bagaimana file itu bermanfaat bagi banyak dari mereka. Kemudian, saya ingin lebih. Ketika saya melihat bahwa bagian Database tidak memiliki daftar yang didedikasikan untuk alat tersebut, saya memutuskan untuk menambahkan milik saya.
Apa yang Anda butuhkan untuk itu?
- Daftarkan GitHub-repo standar dan beri nama seperti awesome-smth – dalam kasus saya, ini adalah awesome-database-tools.
- Sesuaikan daftar dengan luar biasa format menggunakan generator-awesome-list yang akan menghasilkan semua file yang diperlukan dalam format yang tepat.
- Konfigurasikan continuous integration (CI) – awesome-lint dan Travis CI akan membantu kami mengontrol validitas daftar.
- Tunggu selama 30 hari.
- Tinjau setidaknya 2 permintaan tarik lainnya.
- Buat permintaan tarik ke repo utama, dan tambahkan tautan ke repo kita sendiri. Penting :Baca dengan cermat semua banyak persyaratan ke daftar baru dan tarik permintaan, dan ikuti dengan tepat.
Upaya pertama saya tidak berhasil.
Namun, setelah beberapa waktu, saya mengumpulkan lebih banyak materi, mengerjakan pekerjaan rumah, memperbaiki kesalahan, dan mencoba untuk kedua kalinya.
Tapi saya lupa satu hal penting, dan mereka mengingatkan saya tentang hal itu dengan sopan:
Saya tidak cukup perhatian dan tidak menambahkan unicorn sebagai konfirmasi dari semua kondisi terpenuhi.
Beberapa waktu berlalu, saya mendapat beberapa komentar dan menambahkan amandemen, dan, akhirnya, saya melihat twit yang sudah lama ditunggu-tunggu bahwa PR saya telah diterima.
Inilah cara saya membuat daftar pertama saya dan mulai menerima permintaan tarik komunitas untuk menambahkan alat baru. Banyak dari mereka sudah disertakan dalam Alat Database Luar Biasa.
Jika Anda memiliki ide bagus untuk database – jangan ragu untuk membagikannya. Selain itu, saya akan dengan senang hati menerima umpan balik dari Anda, seperti permintaan tarik dan bintang. Jika Anda memiliki pertanyaan tentang membuat daftar Anda sendiri, beri tahu saya.
Anda dapat menghubungi penulis di [email protected].
