Selamat datang di halaman Panduan Kontribusi, pada halaman ini akan dibahas mengenai tata cara dan beberapa aturan saat melakukan kontribusi yang dimana agar menyeragamkan dan membuat semua teratur. Anda bisa memberikan kontribusi berupa materi/artikel, ide, ataupun development untuk perkembangan SinauDev itu sendiri. Namun, sebelum memulai nya anda diharuskan mengikuti beberapa aturan dan petunjuk dalam melakukan kontribusi.

Untuk memulai nya, anda diwajibkan mempunyai akun GitHub yang dimana akan dipakai untuk sarana pengiriman materi atau commit materi. Bagi yang memang belum paham untuk menggunakan Git dan GitHub bisa bertanya pada grup Telegram https://telegram.me/sinaudev . Kami akan dengan senang hati membantu anda.

Kami anggap bahwa anda sudah memiliki akun GitHub dan sudah mengerti bagaimana menggunakan GitHub tersebut. Berikut adalah langkah-langkah untuk melakukan kontribusi materi/artikel :

  1. Fork repositori berikut https://github.com/SinauDev/SinauDev.github.io . Klik pada tombol bertuliskan fork dan lalu pilih akun GitHub anda

  2. Setelah itu repositori tersebut akan masuk kedalam akun anda. Contoh : https://github.com/aancw/SinauDev.github.io

  3. Clone repositori yang sudah di fork sebelumnya ke PC/komputer anda. Anda bisa melakukan nya dengan menggunakan git console ataupun menggunakan GUI Git Client. Untuk dokumentasi dan referensi bacaan bisa lihat disini https://help.github.com/articles/fork-a-repo/

  4. Setelah melakukan clone tersebut, sekarang anda sudah bisa membuat artikel/materi yang akan dikontribusikan. Adapun beberapa hal yang harus diperharikan sebagai berikut:
    • Artikel/materi harus dibuat dalam direktori _posts
    • Artikel/materi harus menggunakan format markdown dan harus berekstensi .md dengan format YYYY-MM-DD-Judul-Materi.md
    • Bila artikel/materi tersebut merupakan materi ber-seri (baca chapter), maka gunakan format YYYY-MM-DD-Judul-Materi-nomorseri.md contoh: 2016-07-08-CPP-Mengenal-Variabel-1.md 2016-07-08-CPP-Mengenal-Pointer-2.md
    • Untuk format post bisa melihat pada template berikut _posts/2016-07-06-Contoh-Post/
    • Silahkan membuat author info pada direktori author seperti pada contoh yang sudah ada. Nama berkas yang ada pada direktori author akan digunakan pada bagian author untuk ditampilkan pada bagian bawah artikel. Jadi, nama author pada berkas yang dibuat dalam direktori _posts dengan nama berkas pada direktori _author mesti lah sama.
    • Diharapkan artikel/materi adalah kepemilikan pribadi. Bila memang saduran, diharapkan mencantumkan sumber asli. Selain dari itu akan dihapus.

  5. Setelah proses selesai, maka selanjutnya anda melakukan git push terhadap repositori yang sudah di-fork sebelumnya. Dan lakukan pull request untuk melakukan permintaan update pada repositori utama.

  6. Tunggu sampai commit anda diterima oleh admin. Bila anda tidak ingin menunggu dan ingin menjadi anggota pada GitHub Organization, anda bisa kirim email permintaan menjadi anggota ke sinaudev@gmail.com atau join grup telegram dan request untuk invite kedalam GitHub Organization sebagai anggota.

Panduan ini akan diperbarui bila ada penambahan yang dibutuhkan. Kritik dan saran bisa dikirimkan ke email sinaudev@gmail.com atau melalui grup telegram https://telegram.me/sinaudev.

Terimakasih atas waktu yang anda luangkan untuk membaca panduan ini. Kami akan sangat senang dan berterimakasih bila anda bisa melakukan kontribusi untuk perkembangan Sinau Development.