I-BEGO

Pada intinya,

Bagi Penulis Code.

1. Komentar pada baris code.
Alangkah baiknya jika setiap baris ada komentar mengenai maksud penulisan kode tersebut. Namun kadang-kadang tidak tersedia lebih banyak waktu untuk menuliskannya.

2. Penamaan Variabel:
Untuk variabel yang bersifat Global (dikenal oleh seluruh class dan function), sebaiknya di beri nama yang bisa dipahami secara mudah. Walaupun untuk mengetiknya butuh waktu lebih lama dikit, kalau sudah hafal akan lebih mudah menelusurinya.

Sedangkan untuk variabel lokal (hanya dikenal di dalam sebuah fungsi), itu sangat relatif.
Kadang-kadang (bahkan sering) di dalam satu fungsi terdapat beberapa loop. Dalam hal ini jika loop-loop tersebut bukan nested loop, sebuah variabel bisa dipakai berkali-kali untuk keperluan berbeda. Namun kalau satu variabel dipakai berulang kali, yang baca bisa bingung juga tuh, malah kadang-kadang yang bikin juga bisa bingung.


Bagi Pembaca Code, untuk bisa memahami isi suatu kode, maka:
1. Sebaiknya punya kompilernya.
2. Pahami dulu maksud dan tujuan kode program secara keseluruhan. Cobalah di Run supaya lebih bisa memahami maksud si programer membuatnya.
3. Pahami setiap Fungsi atau Subrutin yang ada di dalam kode:
=> Maksud dan Tujuan dibuatnya fungsi/subrutin tersebut
=> Parameter yang digunakan. Lihat juga pakah parameternya berupa nilai statik ataukah pointer.
=> Nilai yang dikirimklan kembali dari fungsi/subrutin.
=> Jika di dalam fungsi tersebut terdapat nested condition yang kompleks, cobalah menggambarkan sketsanya pada sehelai kertas.
=> Jika suatu fungsi/subrutin menggunakan suatu algoritma tertentu, maka pahami juga dasar-dasar algoritma tersebut.
=> Pahami juga Penangnan Error pada fungsi tersebut.

Demikian ulasan saya

ini saya tambahkan ada bbrp artikel bagus
Improve Programmer Skill
Penamaan Variable Menggunakan Hungarion Notation
Cara Penulisan Source Menggunakan Indent Style

ada tulisan yang cukup menarik dari artikel di atas :
Copying and pasting others' code is a bad habit \
Don't copy code from another program unless you have permission or the license permits it, like Open Source licenses.

kalaw baca doank .. anak SD juga bisa

yang terpenting adalah =" "
paham terhadap .code-code .yang digunakan
befungsi untuk apa saja..
dan menuju ke mana code-code itu di arahkan..

metal5rigala wrote:kalaw baca doank .. anak SD juga bisa

yang terpenting adalah =" "
paham terhadap .code-code .yang digunakan
befungsi untuk apa saja..
dan menuju ke mana code-code itu di arahkan..

OOT

anak sd di sekolah apa om ???
sampe bisa baca bahasa inggris atau source seperti permainan sehari-hari ???



BTT
klo saya sich tidak hanya paham saja om, misalkan dalam program menggunakan variable2 yang aneh
ex :

Code: Select all

dim Bantai as string
dim Cinta as boolean
dim xxx as integer
dim blablabla as ...
dst


trs program nya di baca oleh programer lain, apa hal pertama yang terlintas d pikiran pembaca ???

Code: Select all

If cinta = false then
  bantai = "Sikat Habis"
  xxx = 999
  blablabla = .....
else
  bantai = "Nothing"
  xxx = 999
  blablabla = .....
end if


metal5rigala wrote:kalaw baca doank .. anak SD juga bisa

iya . . . saya aja waktu sd sama seluruh saudara saya waktu sd nggak ada tuh yang bisa baca source code minimal kaya fungsi copy file, kalau bicara sebaiknya diperhatikan dulu , karena ini menyangkut sharing teknik kepada para pemula kaya saya

Achmadpdam wrote:terima kasih para mas-mas yang menjawab .

jadi intinya sering membaca source code dan menulis source code aja ya om .
tapi kadang-kadang ada istilah-istilah dalam kode program yang sama sekali tidak saya mengerti
seperti ( misalnya ofset e_magic number ,dll )
sehingga saya jadi malas membacanya lagi ( karena saya sama sekali tidak mengerti istilahnya )
itu bagaimana pemecahannya mas-mas ??

terima kasih sebelumnya .

Setuju dengan om Achnad. Lebih mudah memang jika "Learning by doing"