🤝 Kontribusi & Lisensi Project

Terima kasih telah tertarik untuk berkontribusi pada proyek Buku Kampus! Project ini bersifat open-source dan sangat terbuka bagi siapa saja yang ingin membantu mengembangkan catatan atau materi baru.

Saat ini, sebagian besar konten berfokus pada materi Teknik Informatika. Namun, jika kamu ingin menambahkan materi dari bidang lain, kontribusi kamu tetap sangat diterima dan akan membantu memperluas cakupan pembelajaran di project ini.

Cara Berkontribusi

Sebagian besar website ini dibangun dengan coding, jadi jika kamu ingin berkontribusi langsung, kamu bisa menambahkan atau memperbaiki materi melalui repository atau folder project ini.

Berikut adalah langkah-langkah untuk mulai berkontribusi:

Fork Repository

Kunjungi project GitHub Buku Kampus dan klik tombol “Fork” untuk membuat salinan repository ke akun GitHub kamu.

Clone Repository

Setelah melakukan fork, clone repository tersebut ke komputer lokal kamu menggunakan perintah:


git clone

Buat Cabang Baru

Sebelum melakukan perubahan, buat cabang (branch) baru untuk penambahan atau perbaikan yang akan kamu lakukan:


git checkout -b add-kalkulus # (Sesuaikan nama cabang dengan perubahan yang kamu buat)

Lakukan Perubahan

Project ini menggunakan format MDX untuk memuat halaman-halaman materi atau catatan.

Jika kamu ingin menambahkan materi baru, buat folder baru di dalam app/docs dengan nama topik yang sesuai, lalu tambahkan file page.mdx di dalam folder tersebut.
Untuk mengedit materi yang sudah ada, edit file page.mdx yang relevan di dalam folder yang sesuai, misalnya app/docs/kalkulus/page.mdx.

Untuk sintaks penulisan file MDX, kamu bisa merujuk ke dokumentasi Nextra .

Commit dan Push Perubahan

Setelah selesai melakukan perubahan, commit perubahan tersebut dengan pesan yang jelas:


git add .
git commit -m "Menambahkan materi Kalkulus"
git push origin add-kalkulus # (Sesuaikan dengan nama cabang yang kamu buat)

Buat Pull Request

Kunjungi repository GitHub kamu, lalu buat Pull Request (PR) dari cabang yang telah kamu buat ke cabang master pada repository asli Buku Kampus.

Jika kamu ingin berkontribusi namun enggan ngoding 😹😹😹 kamu bisa click di sini dan membuat issue baru untuk menyampaikan ide, saran, atau perbaikan yang kamu inginkan. Jika ada pertanyaan lebih lanjut seputar kontribusi, jangan ragu untuk menghubungi saya di sini

Lisensi Project

Project ini dilisensikan di bawah Creative Commons Attribution-ShareAlike 4.0 International (CC BY-SA 4.0) . Dengan berkontribusi pada proyek ini, kamu menyetujui bahwa kontribusi kamu akan dilisensikan di bawah lisensi yang sama.

Siapa pun diizinkan untuk:

Menyalin dan mendistribusikan materi dalam bentuk dan media apa pun.
Mengadaptasi, mengubah, dan membuat karya turunan untuk segala tujuan, termasuk komersial.

Dengan syarat:

Kamu harus memberikan attribusi yang sesuai: menyebutkan penulis asli, menyertakan tautan ke sumber (misalnya repository), mencantumkan tautan ke lisensi, dan menyatakan jika kamu melakukan perubahan.
Jika kamu membuat karya turunan, kamu harus mendistribusikan karya turunan tersebut di bawah lisensi yang sama (ShareAlike/SA).
Kamu tidak boleh menambahkan pembatasan hukum atau teknologi yang mencegah orang lain melakukan hal-hal yang diizinkan oleh lisensi.

Lisensi ini tidak memberikan jaminan apa pun; penulis atau kontributor tidak bertanggung jawab atas kerusakan yang mungkin timbul dari penggunaan materi ini.

Ringkasnya: Bebas digunakan, asal menyertakan kredit dan membagikan turunan dengan lisensi yang sama (CC BY-SA 4.0).