Tips Berkomentar Ria Di Kodingan

Setiap kerja tim, apalagi programmer, dituntut untuk selalu cepat dan efisien. Tidak ada jambak-menjambak rambut, tidak ada main salah-salahan, dan tidak ada yang mau enaknya sendiri.

Terkhusus programmer, apalagi kerja tim yang sharing kodingan, pastinya harus mengerti kodingan satu sama lain. Ditambah lagi, ada beberapa tim yang memang masih tergolong junior untuk mengerjakan tugas-tugas produksi. Maka dari itu, sudah menjadi tugas senior untuk membuat para junior paham dan tidak membuang waktu lagi untuk mencari-cari kodingan yang dimaksud.

Apa yang harus dilakukan? Orang-orang pastinya akan selalu dan selalu memberikan banyak komentar pada kodingan mereka, termasuk saya. Bahkan para junior pun seharusnya belajar untuk selalu memberikan komentar pada setiap program yang mereka tulis. Karena komentar adalah sebuah fitur untuk menuliskan apapun dengan sebab compiler akan mengacuhkan komentar.

Tapi… tak jarang kodingan yang muncul terkadang justru jadi saingan berita politik karena terlalu banyak komentar.

Tidak betah dengan akibat yang seperti ini, saya membuat beberapa tips bagi diri saya yang akan saya tulis di sini, mengenai manajemen komentar pada blog.


  • Komentar dapat jadi bookmark

Saya pernah diajari oleh seseorang beberapa tahun lalu, jika ada task/tugas yang masih menunggu untuk dikerjakan, atau ada kodingan yang masih harus dilengkapi di baris tertentu, maka dapat ditandai dengan komentar.

Komentar untuk bookmarknya harus didahului dengan standar yang memiliki tiga macam, yaitu: TODO, HACK, dan BUG.

  1. TODO, jika masih ada yang harus diimplementasi pada baris kode tersebut.
  2. HACK, jika pada kode tersebut masih ada tambalan untuk jalan pintas dengan alasan, “yang penting programnya jalan dulu, tambal dulu saja kodenya.”
  3. BUG, jika dibaris tersebut diasumsikan atau bahkan benar-benar menimbulkan bug pada program, namun penyelesaiannya masih ditunda karena ada prioritas lain.

Contoh:

// TODO: Menambahkan fungsi untuk menampilkan foto pada website
function TampilFoto (URLFoto) {
     // Masih kosong
}

  • Bukan hanya novel, kodingan pun punya kisah

Jangan mentang-mentang saya bandingkan dengan novel, komentar programnya ditulis hingga ribuan baris. Ini kodingan btw, bukan Siti Nurbaya.

Kodingan harus diberikan komentar pada setiap blok tertentu karena pastinya kita ingin paham akan “mengapa saya harus tambahkan kode ini?”, atau “Kapan terakhir kode ini ditambahkan?”

Cukup tuliskan tanggal diubah, dan oleh siapa diubahnya pada setiap blok kodingan (misalnya dalam sebuah fungsi) untuk tahu bagaimana kodingan itu bekerja. Dan sedikit dianjurkan agar dituliskan kapan terakhir kali blok kodingan itu diubah beserta detailnya mengapa diubah agar menjadi dokumentasi sendiri.

Oh, komentar juga dapat menjadi identitas sendiri di setiap awal file kodingan mengenai paparan singkat isi dari file tersebut, beserta sejarah dibuatnya.

Contoh:

// DIUBAH 05/08/2016, ANANDASTOON: Mengganti isi dari variabel url agar dapat beradaptasi dengan domain apapun
function TampilFoto (URLFoto) {
     // Blok kodingannya
}

  • Sebagai algoritma awal, dan analisa

Mengerjakan sesuatu yang baru dan bertahap itu benar-benar merepotkan bukan? Misalnya, kalian disuruh untuk membuatkan sebuah slide tentang foto-foto yang telah disimpan di database. Membayangkan hal tersebut bagaimana tekniknya saja sudah bikin malas, dan kalian mungkin dipaksa untuk mengerjakannya dalam lingkup deadline.

Tenang, The power of commentary sangat diperlukan di sini. Cukup breakdown satu-satu algoritmanya lewat komentar, kemudian kalian dapat mulai menuliskan kodingan-kodingan tepat di bawah komentar tersebut.

Contoh:

// TODO: Menampilkan slideshow foto dari database
// 1. Buat query untuk ambil datanya.
// 2. Render data di HTML menggunakan div
// 3. Masukkan javascript untuk membuatnya menjadi slideshow

Kemudian kalian sempurnakan:

// TODO: Menampilkan slideshow foto dari database
// 1. Buat query untuk ambil datanya.
$query = mysqli_query(...);
// 2. Render data di HTML menggunakan div
while ($hasil = mysqli_fetch_assoc(...)) {
     //Render ke div
} 
// 3. Masukkan javascript untuk membuatnya menjadi slideshow
<script>
//..blah, blah, blah
</script>

Yup, benar-benar dapat membuat kerjaan selesai sebelum deadline berakhir, kemudian kalian tinggal dipromosikan oleh atasan kalian, deh.


  • Menjaga data jika suatu saat diperlukan

Algoritma kalian ternyata salah dan harus diubah? Ingin dihapus semua kodingan yang telah kalian siang malam buat? Jika suatu saat ternyata kodingan kalian yang paling awal yang benar bagaimana? Harus buat ulang lagi begitu karena yang sebelumnya sudah kalian hapus? Capede…

Jadikan saja komentar blok kode kalian itu. Jadi jika suatu saat bos dengan mudahnya berubah pikiran dan minta dikembalikan lagi ke semula, kalian tidak perlu lagi repot-repot mencari dukun untuk meneluh bos kalian hingga dia sungkeman memohon ampunan di kaki kalian. Karena, kalian hanya tinggal meng-uncomment (bahasa Indonesianya apa ya?) kodingan kalian dan… happy ending.

Contoh:

// Berikut adalah kodingan yang masih sayang dibuang
/* Dikomentar saja blok kodenya
function TampilFoto (URLFoto) {
     // Blok kodingannya
}
*/

  • Yang terpenting, jangan banyak ngomen!

Lho, ini apa? Kok sangat bertentangan dengan tips-tips sebelumnya?

Ingat, ukuran file akan lebih besar dan akan lebih lama dibaca karena didominasi dengan komentar. Inilah mengapa banyak file-file HTML yang sedikit lebih lama ditampilkan oleh browser karena terlalu banyak komentar di dalamnya.

Lho, jadi saya harus bagaimana? Komentarkan perlu juga untuk segala sesuatu yang telah dijabarkan sebelumnya? Atau bahkan pada HTML, komentar dapat menjelaskan bahwa akhiran sebuah elemen, </div> misalnya, milik siapa induknya.

Maksud saya, selama tidak perlu memakai komentar, ya tidak usah. Misal, jangan lakukan hal seperti ini:

var abc : int = 90; // ini adalah variabel untuk menentukan radius lingkaran besar

Namun lakukanlah,

var radiusLingkaranBesar : int = 90;

Lebih bersih bukan? Jadi kita pun tidak perlu lelah-lelah untuk membaca kanan kiri. Jangan khawatir menulis variabel seperti itu melelahkan, karena sekarang banyak software text editor yang dibekali dengan autocomplete sehingga kalian cukup pilih sugesti-sugestinya dan tekan enter.


Yup, hanya sebatas itu saja tips dari saya pribadi mengenai manajemen komentar. Siap dengan proyek besar? Semoga tips ini bermanfaat untuk membuat proyek besar yang perlu beberapa tim.

Baik, silakan dilanjutkan ngomennya ~

Suka
Komentar
pos ke FB
pos ke Twitter
🤗 Selesai! 🤗

Nilai

Polling

Sugesti

Permainan


  • Sebelumnya
    10 Tips Untuk Programmer Pemula

    Berikutnya
    Math IS Fun: Menghadapi Nilai-Nilai Besar


  • 0 Jejak Manis yang Ditinggalkan

    Minta Komentarnya Dong...

    Silakan tulis komentar kalian di sini, yang ada bintangnya wajib diisi ya...
    Dan jangan khawatir, email kalian tetap dirahasiakan. 😉

    Kembali
    Ke Atas

    Terima kasih telah membaca artikel Anandastoon!

    Apakah artikelnya mudah dimengerti?

    Mohon berikan bintang:

    Judul Rate

    Desk Rate

    Terima kasih telah membaca artikel Anandastoon!

    Dan terima kasih juga sudah berkontribusi menilai kemudahan bacaan Anandastoon!

    Ada saran lainnya untuk Anandastoon? Atau ingin request artikel juga boleh.

    Selamat datang di Polling Anandastoon.

    Kalian dapat iseng memberi polling seperti di Twitter, Facebook, atau Story Instagram. Pollingnya disediakan oleh Anandastoon.

    Kalian juga dapat melihat dan menikmati hasil polling-polling yang lain. 😊


    Memuat Galeri Poll...

    Sebentar ya, Anandastoon muat seluruh galeri pollnya dulu.
    Pastikan internetmu tetap terhubung. 😉

    Asik poll ditemukan!

    Silakan klik salah satu poll yang kamu suka untuk mulai polling!

    Galeri poll akan terus Anandastoon tambahkan secara berkala. 😉

    Judul Poll Galeri

    Memuat poll...

    Sebentar ya, Anandastoon memuat poll yang kamu pilih.
    Pastikan internetmu tetap terhubung. 😉

    Masih memuat ~

    Sebelum memulai poll,

    Anandastoon ingin memastikan bahwa kamu bukan robot.
    Mohon agar menjawab pertanyaan keamanan berikut dengan sepenuh hati.
    Poll yang 'janggal' berpotensi dihapus oleh Anandastoon.
    Sebab poll yang kamu isi mungkin akan bermanfaat bagi banyak orang. 🤗

    Apakah nama hari sebelum hari Kamis?

    Mohon jawab pertanyaan keamanan ini. Jika jawaban benar, kamu langsung menuju pollnya.

    Senin
    Rabu
    Jumat
    Sabtu

    Atau, sedang tidak ingin mengisi poll?

     

    Wah, poll telah selesai. 🤗

    Sebentar ya... poll kamu sedang di-submit.
    Pastikan internetmu terhubung agar dapat melihat hasilnya.

    Hasil poll 👇

    Menunggu ~

    Ups, sepertinya fitur ini masih dikembangkan Anandastoon

    Di sini nantinya Anandastoon akan menebak rekomendasi artikel yang kamu inginkan ~

    Heihei maihei para pembaca...

    Selesai membaca artikel Anandastoon? Mari, saya coba sarankan artikel lainnya. 🔮

     

    Ups, sepertinya fitur ini masih dikembangkan Anandastoon

    Di sini nantinya kamu bisa main game langsung di artikelnya.

    Permainan di Artikel

    Bermain dengan artikel yang baru saja kamu baca? 😱 Kek gimana tuh?
    Simpel kok, cuma cari kata dalam waktu yang ditentukan.

    Mempersiapkan game...

    Aturan Permainan

    1. Kamu akan diberikan sebuah kata.

    2. Kamu wajib mencari kata tersebut dalam artikel.

    3. Kata yang ditemukan harap diblok atau dipilih.
    Bisa dengan klik dua kali di laptop, atau di-tap dan tahan sampai kata terblok.

    4. Terus begitu sampai kuota habis. Biasanya jumlahnya 10 kuota.

    5. Kamu akan berhadapan dengan waktu yang terus berjalan.

    6. DILARANG Inspect Element, CTRL + F, atau find and replace. Juga DILARANG berpindah tab/windows.