Cara Mudah Ikut Berkontribusi di Projek Orang Lain Dengan Fork Project di GitHub

Setelah mengunakan GitHub sendiri untuk sementara waktu, anda mungkin ingin berkontribusi untuk proyek orang lain. atau mungkin anda ingin mgnggunakan proyek seseorang sebagai titik awal untuk proyek anda sendiri. Proses ini dikenal sebagai forking.

Membuat Fork menghasilkan salinan pribadi dari proyek orang lain. Fork bertindak sebagai semacam jambatan antara repositori asli dan salinan pribadi anda. anda dapat mengirimkan Pull Request untuk membantu menjadikan proyek orang lain lebih baik dengan menawarkan perubahan anda hingga ke proyek asli. Forking adalah inti dari pengkodean sosial di GitHub.

Fork Repository

Untuk Fork Spoon-Knife repository, klik tombol Fork di header repositori.

Apabila Fork sudah selesai anda akan dibawa ke salinan repositori Spoon-Knife

Clone your fork

Anda telah berhasil Fork repositori Spoon-Knife, tetapi sejauh ini, itu hanya ada di GitHub. Agar dapat bekerja di proyek, anda harus mengkloningnya ke komputer anda.

Jika anda menggunakan GitHub Desktop, proses ini sangat mudah. Pada Fork Spoon-Knife navigasikan ke bilah sisi kanan dan klik Clone atau unduh. Bagaimana anda mengkloning terserah anda. beberapa opsi dicloning dengan baris perintah, atau dengan menggunakan GitHub Desktop.

Making and pushing changes

Silahkan dan buat beberapa perubahan pada proyek mengunakan editorteks favorit anda, seperti VSCODE, Atom dll. misalnya teks dalam index.html untuk menambahkan nama pengguna GitHub Anda. Saat anda siap mengirim perubahan anda, stage dan commit perubahan anda.

Saat ini pada dasarnya anda memberi tahu sang pemilik project, "oke saya sudah mengambil snapshot dari perubahan saya" anda dapat terus membuat lebih banyak perubahan, dan mengambil lebih dari banyak commit snapshot. Saat anda siap, Push perubahan anda ke repositori yang sudah di remote.

Making a Pull Request

Terakhir, anda siap untuk mengusulkan perubahan ke proyek utama, ini adalah langkah terakhir dalam menghasilkan fork proyek orang lain, dan bisa dibilang yang paling penting. Jika anda telah membuat perubahan yang anda rasa akan bermanfaat bagi masyarakat secara keseluruhan, anda harus mempertimbangkan untuk berkontribusi kembali.

Untuk melakukannya, pergilah ke repositori di GitHub dimana proyek anda sebelumnya, Sebagai contoh repositori akan menjadi seperti https://www.github.com/<your_username>/Spoon-Knife. Anda akan melihat banner yang menunjukkan bahwa anda baru saja Push branch baru, dan anda dapat mengirimkan branch ini "upstream" ke repositori asli:

Klik di bagian Compare dan Pull Request mengirim anda ke halaman diskusi, dimana anda dapat memasukkan judul dan deskripsi opsional. Sangat penting untuk memberikan informasi yang berguna dan alasan mengapa anda membuat Pull Request ini di tempat pertama. Pemilik repositori harus dapat menentukan apakah perubahan anda bermanfaat bagi semua orang seperti yang anda pikirkan.

Saat catatan perubahan anda sudah di paparkan sejelas mungkin anda tinggal klik kirim Pull Request dan selesai...

Pull Request adalah area untuk diskusi. Dalam hal ini apabila anda melakukan perubahan kemudian meminta Pull Request anda harus mencantumkan lebih detail penjelasan perubahan yang anda buat supaya pemilik repositori asli mengerti dan cepat untuk merge perubahan yang anda minta, apabila pemilik repositori menolak atau meminta perubahan terhadap Pull Request yang anda kirim, segera mungkin dirubah supaya Codingan repositori inti tidak rusak apabila di merge oleh pemilik repositori inti.

Semoga bermanfaat untuk bagaimana cara berkontribusi ke repositori orang lain dan selamat mencoba menjalankan lika liku sebagai penggemar open source

Membuat Dokumentasi Proyek Anda di Github

Membuat Dokumentasi Proyek Anda di Github - Dokumentasi yang dapat diakses memungkinkan orang untuk belajar tentang suatu proyek, membuatnya mudah untuk diperbaharui memastikan bahwa dokumentasi tetap relevan.

Dua cara umum untuk mendokumentasikan suatu proyek adalah file README dan wiki

1. File README adalah cara cepat dan sederhana bagi pengguna lain untuk mempelajari lebih lanjut tentang pekerjaan anda.
2. Wiki di Github membantu anda menyajikan informasi mendalam tentang proyek anda dengan cara yang bermanfaat.

Ide yang baik adalah setidaknya memiliki README di proyek anda, karena itu adalah hal pertama yang akan dibaca banyak orang ketika mereka pertama kali menemukan proyek anda.

Membuat README 

Ketika anda membuat repositori baru melalui GitHub, pilih "Inisialisasi repositori ini dengan README" kecuali anda berencana untuk mengimpor repository yang ada.

File README.md anda sekarang tersedia untuk di edit di repositori baru anda. Nama proyek anda ada di atas, diikuti oleh deskripsi apa pun yang anda pilih untuk dimasukkan saat membuar repositori. README mudah di modifikasi, baik di Github atau secara lokal. Lihatlah panduan menguasai Markdown untuk mempelajari lebih lanjut tentang cara memodifikasi teks di dalam file setelah anda membuatnya.

Format README

README umumnya mengikuti satu format untuk segera mengarahkan pengembang ke aspek terpenting dari proyek anda.

• Nama Proyek: Nama proyek anda adalah hal pertama yang akab dilihat orang saat menggulir ke README anda, dan disertakan saat membuat file README anda.
• Deskripsi: Berikut Deskripsi proyek anda. Deskripsi yang bagus Jelas, Singkat, dan to the point. Jelaskang pentingnya proyek anda dan apa fungsinya.
• Daftar Isi: Secara opsional, sertakan daftar isi agar orang lain dapat dengan cepat menavigasi README yang panjang atau terinci.
• Instalasi: Instalasi adalah bagian selanjutnya dalam README yang efektif. Beri tahu pengguna lain cara memasang proyek anda secara lokal. Secara opsional, sertakan gif untuk membuat proeses lebih jelas bagi orang lain.
• Penggunaan: Bagian selanjutknya adalah penggunaan, dimana anda mengajar orang lain tentang cara menggunakan proyek anda setelah mereka menginstalnya. Ini juga akan menjadi tempat yang baik untuk menyertakan screenshot proyek anda.
• Credits: Sertakan  bagian kredit untuk menyoroti dan menautkan ke penulis proyek anda.
• Lisensi: Terakhir, Sertakan bagian untuk lisensi proyek anda seperti lisensi MIT dll. Untuk informasi lebih lenjut tentang memilih lisensi, lihat panduan lisensi Github

README anda hanya berisi informasi yang diperlukan bagi developer untuk mulai menggunakan dan berkontribusi pada proyek anda. Dokumentasi yang lebih panjang paling cocok untuk wiki, seperti penjelasan dibawah ini.

Membuat wiki

Setiap repositori di Github hadir dengan wiki. Setelah membuat repositori, anda dapat mengatur wiki yang disertakan melalui bar navigasi. Memulai wiki anda mengklik tombol wiki dan membuat halaman pertama anda.

Menambahkan Konten

Konten wiki dirancang agar mudah diedit. Anda dapa menambahkan atau mengubah konten pada halaman wiki apapun dengan mengklik tombol edit yang terletak di sudut kanan atas setiap halaman. membuka editor di wiki.

Halaman wiki dapat ditulis dalam format apapun yang didukung oleh Github Markup. Menggunakan menu drop-down di editor, anda dapar memilih format wiki anda, dan kemudian menggunakan toolbar untuk membuat dan memasukkan konten pada halaman. Wiki juga memberi anda opsi untuk menyertakan catatan kaki khusus di mana anda dapat mendaftar hal-hal seperti detail kotak atau informasi lisensi untuk proyek anda.

Github melacak perubahan yang dibuat untuk setiap halaman di wiki anda. Di bawah judul halaman, anda dapat melihat siapa yang melakukan pengditan terbaru, selain jumlah komit yang dibuat untuk halaman tersebut. Mengklik informasi ini akan membawa anda ke riwayat halaman penih di mana anda dapat membandingkan revisi atau melihat daftar suntingan terperinci dari waktu ke waktu.

Menambahkan Halaman

Anda dapat menambahkan halaman tambahan ke wiki anda dengan memilih Halaman Baru di sudut kanan atas. Secara default, setiap halaman yang anda buat disertakan secara otomatis di sidebar wiki anda dan terdaftar dalam urutan abjad.

Dukungan

Anda juga dapat menambahkan bilah samping khusus ke wiki anda dengan mengklik tautan Tambahkan bilah khusus samping, konten khusus sidebar dapat menyertakan teks, gambar, dan tautan.

Catatan: Halaman yang disebut "Rumah" berfungsi sebagai halaman masuk ke wiki anda. Jika tidak ada, daftar isi yang dihasilkan secara otomatis akan ditampilkan sebagai gantinya.

Penyorotan Syntax

Halaman Wiki mendukung penyorotan sintaks kode otomatis untuk berbagai bahasa dengan menggunakan sintaks berikut: 

```ruby
   deff foo
     puts `bar`
   end
```

Blok harus dimulai dengan tiga backtick, opisional diikuti dengan nama bahasa yang terkandung oleh blok. Lihat pygments untuk daftar bahasa yang dapat disorot sintaks.

Konten blok harus diindentasi pada tingkat yang sama dengan backticks pembuka. Blok harus diakhiri dengan tiga backtick yang indentasi pada level yang sama dengan backticks pembuka.

Done

Anda telah mempelajari beberapa informasi penting tentang cara terbaik membagikan proyek anda dengan komunitas Github lainnya,, Selamat mencoba.