Joshua's Blog

Tulisan ini merupaka catatan saya dalam menerapkan best practice dalam berkolaborasi di dalam tim sedang kami bentuk. Tim kami terdiri dari orang-orang yang memiliki role profesi dan tersebar di jakarta, sehingga kami menggunakan metode asynchronous coordination. Saat ini kami menggunakan berbagai variasi bentuk komunikasi dalam berkolaborasi, baik via telepon, sms, milis, dan yang terakhir adalah redmine. Untuk bentuk yang terakhir, ini adalah media yang berguna untuk membentuk rekam jejak proyek. Read the rest of this entry »

Bagi anda yang kebetulan memiliki tanggung jawab sebagai coder secara langsung dan menggunakan  SVN sebaga sarana repository code anda, Redmine memiliki fitur integrasi dengan SVN sbg bentuk tracking Issue. Berikut ini adalah cara menggunakan SVN agar integrasi dg redmine.

• Pastikan setiap anda melakukan commit. anda selalu menyertakan keterangan pada commit log.
• Apabila pekerjaan yang anda commit menyelesaikan sebuah issue, maka tulis dalam log sbb:
  • fixes #[nomor_issue], ex: fixes #34. #35, dst
• Secara default, redmine akan menyatakan issue tersebut sbg resolved, dan mencantumkan nomor version ke issue terkait.
• Anda dapat menambahkan kata kunci yang dapat digunakan redmine dalam memindai log SVN
• Anda juga dapat menentukan status suatu issue apabila redmine menemukan kata kunci dalam log SVN
• Semua fitur tersebut dapat anda temukan di Administration-> Settings

semoga membantu.

Jika kalian menggunakan subversion, mungkin saat setup environment baru, lebih mudah bila menggunakan VisualSVN. Bila  menggunakan VisualSVN, mungkin kalian pernah mengalami error:

Path [UrlPath] is not canonicalized; there is a problem with the client.

Saya tidak tahu penyebab pasti error ini, dan saya berpikir ini sebuah bug/misconfigurasi dari VisualSVN (semoga mereka sudah mempatch di versi terbaru). Solusi temporer yang paling mudah adalah:

1. Pastikan url tersebut dalam format lowercase.
2. Bila perlu, pastikan nama server/domain/pc svn server juga diset dalam lowercase.

Semoga bermanfaat.

Log4Net adalah sebuah library yang menyediakan fungsi-fungsi logger bagi aplikasi yang dikembangkan dengan .NET. Library ini dikembangkan dari project pendahulunya yang sudah lebih terkenal, yaitu Log4J. Pertama kali saya mencoba Log4Net tidak mengalami banyak kesulitan. Alur Kerja cukup mudah dipahami, contoh-contoh konfigurasi juga disediakan.

Namun, ada beberapa masalah yang mungkin sampai saat ini belum mampu saya cari solusinya saat mengimplementasikan di dalam sebuah website (Visual Studi0 2005 / .NET 2.0).

Permasalahan tersebut antara lain:

• File Config tidak terbaca apabila disimpan terpisah dengan web.config
• Deklarasi assembly untuk membaca konfigurasi seakan tidak tereksekusi.

Solusi sementara yang saya miliki adalah sbb:

• Gabungkan Log4Net.config dengan web.config
• Gunakan Global.asax, dan taruhlah potongan kode berikut pada Application_OnStart:

  log4net.Config.XmlConfigurator.Configure();

Semoga membantu.

Dokumentasi source code mungkin untuk sebagian teman-teman belum menjadi prioritas dalam bekerja. Apalagi jika kita merupakan seorang single fighter atau hanya terdiri dari tim yang kecil. Namun, dengan penerapan OO pada pekerjaan kita, dokumentasi merupakan sesuatu yang mutlak untuk diperhatikan. Untuk programmer java / php, mungkin sudah terbiasa menggunakan source documentation generator seperti JavaDoc atau PhpDoc.

Namun, bagaimana untuk yang menggunakan microsoft .NET? Untuk .NET, ada beberapa software freeware / commercial yang tersedia seperti N-Doc, VSDocMan, dan yang terakhir Sandcastle. Referensi mengenai perbandingan document generator dapat dilihat di wikipedia. Fokus utama yang akan dibahas di dalam artikel ini adalah Sandcastle dengan menggunakan DocProject. Sandcastle adalah software yang dikembangkan oleh microsoft sebagai alat untuk menghasilkan dokumen program dari komentar-komentar yang ada pada sumber program. Sedangkan DocProject merupakan alat bantu untuk sandcastle, karena menggunakan sandcastle secara manual dirasa cukup merepotkan dan membingungkan. Beberapa alasan untuk menggunakan dua software tersebut adalah sbb:

1. Free & Gratis, Sandcastle berlisensi Microsoft Public License, dan DocProject berlisensi GNU/GPL (GPLv2).
2. DocProject lebih mudah digunakan, dan masih didukung oleh komunitas.

Read the rest of this entry »