Contohnya jika anda mempunyai fungsi yang dipanggil..

get_items_in_list

Dalam CamelCase, ia ditulis sebegini,

GetItemsInList

Saya lebih menggemari pemisahan perkataan dengan menggunakan underscore ( _ ), dalam penamaan fungsi (function). Senang nak baca, walaupun agak panjang, tapi senang nak baca tu yang penting.

Tapi yang penting, kena konsisten. Jangan sekejap CamelCase sekejap , sekejap benda lain. Kena ada guideline untuk cara penulisan. Kalau setiap programmer ada style masing-masing (ada yang takdak style, ikut sedap hati dan mood.  Sekejap camelcase, sekejap hungarian notation, etc) haru-biru la gamaknya.  Dan kalau kena maintain sistem, programmer sebelum ni dah pakai CamelCase secara konsisten terpaksa la ikut.

Oleh kerana saya telah menulis pelbagai kod sebagai projek sampingan (pet project) yang tidak dapat disiapkan (tiba-tiba banyak pulak kerja) dan dibiarkan terbengkalai selama 3-6 bulan (ada yang sampai bertahun) dan kemudiannya saya sambung balik, ianya secara tidak langsung melatih saya untuk menulis kod dengan lebih teliti supaya  pada masa akan datang saya dapat memahami kod yang ditulis dan sambung menulis kod tersebut.

Ok, setakat tu sahaja untuk hari ni. Nak kena sambung baca kod orang (dan baiki indentation, *sigh*, masih ramai tak reti guna IDE dengan betul).

Selamat Programming!

Saya pun tak berapa reti C++, maklumlah selama bekerja ni tak berpeluang nak guna.

Saya tidak menterjemah IDE kerana saya takut akan hasil daripada terjemahan saya , dan jika ianya diterjemahkan pun anda tidak mungkin akan digunakan kebanyakan masa (99% daripada masa anda membangunkan perisian/bekerja), melainkan anda vendor kerajaan ataupun kakitangan kerajaan, itupun didalam kertas kerja. Kalau anda tahu, dialu-alukan memberitahu saya didalam ruangan komen.

Jadi, apa yang anda cari didalam IDE? Sudah tentulah fungsi untuk memudahkan aktiviti pengaturcaraan, tetapi apakah itu? Jikalau anda mempunyai ’swiss army knife’ tetapi tidak tahu apa yang boleh dilakukannya selain memotong, anda berada dalam keadaan yang rugi. Rugi kerana tidak menggunakan IDE anda dengan sepenuhnya (50% pun oklah). Anda tidak perlu mengenali kesemua fungsi didalam IDE anda, setakat tahu apa yang anda mahu, itu pun memadai.

Sebuah IDE terdiri daripada:

• source code editor
• a compiler and/or an interpreter
• build automation tools
• a debugger (ataupun dalam BM, pengayahpijat)

Tertera diatas adalah kebolehan asas didalam sesebuah IDE. Terdapat banyak lagi kriteria yang digunakan untuk membandingkan sesuatu IDE, seperti berikut:

• profiler
• code coverage
• static code analysis
• autocomplete
• class browser
• dan pelbagai lagi..

Ciri-ciri yang dipilih oleh seseorang pengaturcara selalunya bergantung pada diri masing masing. Setiap pengaturacara adalah unik dan bukan semua pengaturcara dapat menyesuaikan diri pada IDE, melainkan terdapat sesuatu pada IDE tersebut yang harus digunakan untuk membangunkan jenis perisian tersebut, contohnya pembangunan perisian .NET pada Windows memerlukan Microsoft Visual Studio (walaupun terdapat alternatif seperti SharpDevelop – kebanyakan member yang test tak suka). Jika seluruh pasukan anda (5-10 orang) menggunakan Eclipse, kemungkinan besar anda terpaksa menggunakan Eclipse, kerana apabila pasukan anda membincangkan sesuatu dan menggunakan istilah yang hanya terdapat pada IDE tersebut, anda akan tersisih dan kekeliruan (ape bende derang cakap nih?)

IDE yang banyak digunakan oleh orang (yang selalu didengar oleh saya) adalah seperti berikut:

• Eclipse (juga terdapat PHPEclipse)
• Adobe Dreamweaver
• Netbeans
• beberapa lagi yang tak dapat saya ingati pada masa kini.

IDE yang saya gunakan adalah Komodo Edit. Dan saya mungkin akan beralih ke IDE lain jika ianya memenuhi kehendak saya didalam persekitaran pembangunan perisian saya (kadang-kadang setiap 6 bulan saya akan uji IDE baru).

Apa yang saya perlukan:

• Project View
• Multiple Tabs
• Code snippet, macro, etc
• Autocomplete (Code Intelligence)
• Class Browser
• Todo
• Code Folding
• Bookmark
• Brace matching
• Auto indentation
• Function list
• Regex-based find & replace (regular expression)

Tiada plugin untuk SVN, tiada option untuk terus muat naik (upload) ke server. Mengapa? Kenapa? Saya sudah mempunyai perisian untuk melakukan tugasan-tugasan berikut, TortoiseSVN dan Filezilla. “Tapi, kalau dalam IDE tak payah nak pegi tempat lain“, ya, mungkin benar tetapi saya cuba meminimakan apa yang sedang berjalan (running) dalam PC saya dan apabila perisian itu adalah ’standalone’, ia dapat melakukan tugasnya dengan lebih baik daripada ‘plugin‘. Kerana ia adalah ‘specialist‘ (atau pakar – hehe). Itu hanyalah saya, saya mempunyai sesuatu yang lebih saya suka daripada yang lain (preference).

Cuba dan eksperimen dengan persekitaran pembangunan perisian yang sesuai dengan jiwa dan keadaan anda. Jangan lupa untuk berkongsi dengan saya.

Begitu juga dalam programming, terdapat beberapa langkah persediaan yang perlu dilaksanakan sebelum memulakan aktiviti ini.

Jika hanya anda seorang:

• version control

Jika lebih dari seorang:

• version control
• issue tracking (jika lebih dari seorang) ataupun mana mana perisian yang dapat senaraikan tugas / isu.
• wiki
• coding guideline
• terdapat beberapa lagi yang tidak akan disentuh disini seperti automated testing, automated build/deployment

Version Control

Walaupun anda seorang, version control dapat menyelamatkan anda (dan tentunya disaat yang genting) apabila anda membuat pengubahsuaian pada kod. Contohnya, anda implement suatu feature pada perisian anda yang diminta oleh pelanggan. Kemudiannya mereka tidak mahu pula feature tersebut, adakah anda akan komen kod tu  (risau mereka mahu pula kemudiannya) ? ataupun anda akan hasilkan fail baru dan namakan fail lama sebagai filename.php.old ?

Cara-cara begini telah banyak saya saksikan, selain daripada menyerabutkan mata dan kepala ia juga menganggu keyakinan diri (mungkin), kerana anda takut replace fail yang penting. Dengan menggunakan ‘version control’, anda hanya perlu ‘commit’ (lebih kurang macam save) perubahan yang anda lakukan akan direkod sebagai, contohnya, revision 2. Dan jika user tidak mahu feature tersebut, anda hanya perlu ambil fail pada revision 1 untuk kembalikannya pada yang asal sebelum anda melakukan perubahan. DAN JIKA user nak tambah balik, retrieve aje lah revision 2. Tak perlu pening pening kepala, tapi jangan cakap kat user senang untuk membuat perubahan (supaya boleh caj tinggi sikit – jahatnya, hehe).

Paling penting sekali penggunaan VCS (version control system) ni apabila ramai pengaturcara, sekejap si Ahmad nak edit fileX, dalam masa yang sama si Abu pun nak edit. Haaa, macam mana? Sila rujuk topik ‘merging‘ dalam perisian VCS anda.

Perisian yang saya gunakan untuk version control adalah Subversion (SVN) dan pada bahagian client adalah TortoiseSVN. Jika anda menggunakan windows dan ingin memudahkan proses install dan konfigurasi, gunakan VisualSVN. Saya menggunakan Subversion biasa dan apache untuk mengakses repository.

Terdapat beberapa juga jenis VCS yang berpusat (centralized) dan teragih (distributed). SVN adalah centralized. Git adalah distributed. Maklumat lanjut akan dihuraikan dalam post yang akan datang.

Issue Tracking

Dalam pembangunan perisian, gerenti banyak isu atau tugasan (jangan letak dalam kepala, kepala kita ni bukan harddisk sekejap je boleh lupa), anda perlulah menulisnya samada dalam buku nota, Google Notebook, ataupun pada perisian issue tracking.

Perisian yang saya selalu gunakan adalah Mantis BugTracker, walaupun dia tulis situ ‘BugTracker’, ia boleh digunakan untuk kegunaan umum bukan hanya pada ‘bug’. Tak percaya? Hubungilah saya, saya kan menerangkan dengan lebih lanjut. Aplikasi web ini agak rumit untuk difahami secara menyeluruh, anda perlu menggunakannya untuk mengenalinya dengan lebih cepat.

Dengan menggunakan issue tracking ini juga, anda dapat menjejak isu isu agar ianya tidak hilang ditelan zaman (selalu berlaku pada email), ataupun masuk telinga kanan keluar telinga kiri.

Wiki

Anda tahu apa itu wiki? Tak tahu? Jika anda pernah menggunakan wikipedia, maka anda menggunakan wiki tanpa menyedarinya. Saya menggunakan wikipedia pada awal tahun 2004 (atau mungkinkah lebih awal? saya tak berapa ingat). Pada ketika itu, tidak banyak maklumat didalamnya. Setelah beberapa tahun berlalu, ramai orang mencurahkan maklumat kedalamnya dan sedikit demi sedikit ianya disunting untuk memperbaiki kualitinya. Sehinggalah sekarang, ia menjadi rujukan utama apabila seseorang itu berada didepan komputer yang mempunyai internet.

Saya pernah menceritakan kepentingan wiki didalam blog saya bertajuk, Why an internal wiki is important for a growing development team (or an entire company), (fuh, panjang betul tajuk tu) dimana didalam konteks pembangunan perisian, ia dapat digunakan sebagai developer-level documentation. Kebanyakan tempat tidak mempunyai developer-level documentation, dimana ia selalu disanggah seperti “Ah, tak payah la tu, ko baca je komen dalam kod“, “Kod aku tu jelas, terang dan simple, ko tengok je mesti ko paham”, dan pelbagai lagi.

Antara kepentingan wiki (saya terjemah dari blog saya):

• Mempermudahkan ahli baru pasukan merujuk maklumat mengenai projek
• Mengajar bagaimana untuk menyusun maklumat anda dan rakan anda supaya senang difahami (dapat membantu dalam menulis kod yang lebih baik).
• Menggalakkan dokumentasi, dan juga cara berkomunikasi dalam bentuk bertulis.

Jika persekitaran anda masih tidak mempunyai wiki, disarankan untuk mewujudkannya. Selalunya  jika anda memperkenalkan sesuatu yang baru, tentangan (“resisting change”) pasti akan berlaku, dalam keadaan sebegini, cuba menerangkan lagi kebaikan wiki untuk memupuk semangat (ataupun keinginan) untuk memperbaiki cara kerja kearah yang lebih baik. Jika semua gagal, cuba raih sokongan bos ataupun pihak pengurusan supaya menurunkan arahan supaya pengaturcara digalakkan (ataupun diharuskan) sumbang pada wiki (KUKU BESI! WAAARGGH!).

Saya menggunakan mediawiki untuk perisian wiki.

Coding Guideline

Coding guideline selalunya termasuk didalam wiki. Ianya penting dan tak banyak syarikat yang ada. “Coding ni proses kreatif, mana boleh semua kena ikut macam ni”, taik unta, mahu tak mahu satu pasukan kena setuju dengan suatu garis panduan yang dibincangkan terlebih dahulu. Lepas tu semua kena ikut. Dalam IDE, automatically convert tabs to space, satu tab sama dengan 4 space. Gaya curly brace ( { ), samada 1TBS (One True Bracing Style), Allman(BSD style), Whitesmith ataupun GNU.

Saya lebih menggemari gaya BSD
foreach($somearray as $key => $value)
{

}
Berbincang dan bersetuju dengan satu garis panduan, atau paling malas pun ambil mana mana coding guideline dari Zend ke, Drupal ke, ataupun Mozilla.

Harap tips dan huraian ini dapat membantu anda samada didalam kerjaya ataupun hobi.

Selamat programming!