Halo semua!
Pada bulan ini kami dengan bangga menyatakan bahwa proyek-proyek Ikatan Alumni TOKI secara resmi go open source!
Seluruh kode pada proyek-proyek yang sedang dikembangkan dirilis pada GitHub: https://github.com/ia-toki. Saat ini, terdapat tiga proyek besar yang sedang aktif:
- Judgment Angels
- Materi TOKI Training Gate (baru!)
- tcframe (Test Cases Generator) (baru!)
Pada blogpost ini, akan dibahas mengenai proyek Judgels saja. Kedua proyek sisanya akan dibahas pada blogpost tersendiri.
Judgels Goes Open Source
Sebagai laporan, Judgels sudah berhasil digunakan dengan sukses pada TOKI Open Contest Beta Testing #1, dan pada Pelatnas 2 TOKI 2015. Dengan kata lain, Judgels sudah bisa dikatakan “cukup stabil” dan sudah layak untuk mulai dibuka kodenya kepada publik. Versi yang sudah dirilis sejauh ini adalah versi 0.1.0 (baru saja dirilis).
Sebuah proyek open source tentu kurang lengkap tanpa adanya dokumentasi. Pada rilis ini, kami menyertakan beberapa dokumentasi:
- Javadoc: http://ia-toki.github.io/judgels/javadoc/v0.1.0/
- Manual: https://judgels.readthedocs.org/en/v0.1.0/
Kami menyadari bahwa saat ini kedua dokumentasi tersebut masih jauh dari sempurna. Misalnya, Javadoc belum ada dokumentasi method/class sama sekali, dan manual masih sebatas informasi-informasi dasar saja. Kami (atau bahkan Anda!) akan terus menyempurnakannya pada versi-versi berikutnya.
Terdapat beberapa jenis kontribusi yang bisa rekan-rekan lakukan jika berminat, antara lain:
Feature request/bug report, terutama bagi yang sudah pernah menggunakan Judgels sebelumnya, misalnya saat Open Contest. Mimpi kami adalah membuat Judgels dipakai di APIO dan IOI di tahun-tahun mendatang. Jadi, kontribusi ide sangat diharapkan. (P.S. Judgels memang akan digunakan pada APIO 2015 yang diselenggarakan Indonesia pada Mei mendatang.)
Proofread + memperbaiki/memberi masukan manual. Salah satu kesulitan menulis manual adalah sang penulis (yakni, kami) telah memiliki pengetahuan mengenai sistemnya, sehingga bisa bias untuk pengguna awam. Oleh karena itu, kontribusi pada area ini dapat secara sederhana diawali dengan: bisakah kalian menginstall Judgels pada sistem lokal kalian, dengan hanya membaca dokumentasinya? Jika tidak, berarti ada yang salah dengan manual yang kami tulis silakan dilaporkan.
Menambahkan dokumentasi Javadoc. Untuk mempercepat pengerjaan fitur, kami menunda penulisan Javadoc. Kemudian terlintas ide, bagaimana kalau dokumentasi ini dikerjakan secara crowd-sourcing saja? (a.k.a. KawalJavadocJudgels :p) Jadi, bagi kalian yang berminat dan telah mempelajari kodenya, mungkin bisa membantu pada bagian ini.
Dan tentu saja, turut serta mengerjakan fitur-fitur! Kami telah membuat section Developer’s Guide pada manual; silakan dibaca-baca terlebih dahulu. Apabila terasa masih kurang informatif mohon dimaklumi — akan segera disempurnakan pada versi-versi mendatang.
Keseluruhan kode dibuka dengan lisensi GPL v2, yang “tldr;”-nya: Judgels bebas digunakan untuk keperluan apapun, asalkan tetap open source apabila didistribusikan.
Jika ada pertanyaan, atau niat baik kontribusi, silakan layangkan dalam bentuk Issue pada repo judgels agar ter-track dengan baik. Kami akan berusaha agar menanggapi, memberi masukan, dan mengorganisasikannya pada timeline proyek ini.
Terima kasih
P.S.: Spoiler: setelah didiskusikan, nama TOKI Learning Center yang selama ini menjadi brand, akan digantikan dengan nama baru yang lebih fresh. Nantikan info lebih lanjutnya!
Eh step2 untuk feature request / bug report didokumentasiin dunk ._.
not sure semua orang ngerti ._. *termasuk saya :v
Sudah ditambah hehe, pokoknya submit sebagai issue dulu saja, nanti kita yang rapi-rapikan.