Introspeksi Dokumentasi Project

[Endy Muhardin]

Salah satu pertanyaan yang sering ditanyakan di milis ini adalah:

- dokumen apa saja yang harus kita buat selama mengerjakan project?

- apa kegunaan masing-masing dokumen?

Pada artikel ini, Steve McConnell membahas tentang 

bagaimana menilai apakah dokumentasi yang kita lakukan dalam project

sudah efektif atau belum. 

http://www.construx.com/10x_Software_Development/Software_Project_Archaeology/ 

Dia membahas beberapa pertanyaan yang harusnya kita ajukan terhadap diri sendiri 

dengan melihat dokumen yang ada / tidak ada dalam project. 

Dari jawaban terhadap pertanyaan tersebut, kita bisa menilai 

- apakah kita sudah membuat jenis dokumen yang benar?

- apakah kita sudah membuat dokumen dengan benar?

- dsb

Endy Muhardin
http://software.endy.muhardin.com

[Daud Mukadar]

goodreads, thx for sharing,

semakin mengukuhkan kalo bikin software itu lebih dekat ke seni daripada engineering :D

.daudmukadar

2013/4/27 Endy Muhardin <endy.m...@gmail.com>

--
Anda menerima pesan ini karena Anda berlangganan grup "Manajemen Proyek IT" dari Grup Google.
Untuk berhenti berlangganan dan berhenti menerima email dari grup ini, kirim email ke it-project-indonesia+berhenti berlan...@googlegroups.com .
Untuk mengeposkan pesan ke grup ini, kirim email ke it-project...@googlegroups.com.
Kunjungi grup ini di http://groups.google.com/group/it-project-indonesia?hl=id.
Untuk opsi lainnya, kunjungi https://groups.google.com/groups/opt_out.
 
 

[T. Budiman]

2013/5/4 Daud Mukadar <daudm...@gmail.com>

goodreads, thx for sharing,

semakin mengukuhkan kalo bikin software itu lebih dekat ke seni daripada engineering :D

Apa yang menyebabkan munculnya kesimpulan demikian? Apakah karena dokumentasi proyek dianggap bersifat opsional? Atau tidak standar? Atau dianggap tidak berpengaruh pada hasil pekerjaan? 

 

[Ivan Darmawan]

Lebih dekat ke seni karena hasilnya tidak harus sesuai dengan yang direncanakan. Namun dalam proses development-nya diharapkan mendekati best practice (engineering) yang disukai.

2013/5/4 T. Budiman <tbud...@gmail.com>

--

[Martinus Johan Wahyudi]

udah ah, kejauhan mengkaitkan seni ke IT. Engineering is not art :) unless you feel an emotion for that..

2013/5/7 Ivan Darmawan <ivan.d...@gmail.com>

--
Sincerely,
Martinus J Wahyudi
Software Engineer

[Endy Muhardin]

Nah, software development is art ini menurut pengalaman saya adalah alasan untuk tidak memiliki dan melakukan proses yang baku. 

Jadi ya bisa ditebak, hasilnya tidak repeatable. 

Sekarang on time on budget, next project belum tentu. 

Kalo yang saya pahami dari artikel di atas : 

- kita harus punya seperangkat proses dan dokumen yang baku

- proses/dokumen tersebut harus jelas : 

  - apa manfaatnya

  - siapa yang membuat/melakukan dan kapan dibuat/dilakukan

  - siapa yang mengupdate dan kapan diupdate

  - siapa yang membaca dan kapan dibaca

- ada verifikasi/evaluasi apakah proses/dokumen tersebut benar2 bermanfaat

Nah, yang namanya engineering itu, ciri khasnya ada metodologi, ada analisa, dan ada evaluasi/improvement.

Engineering seperti ini :

Step 1 : mari kita lakukan X

Step 2 : coba kita cek apakah kita sudah benar2 melakukan X

Step 3 : coba kita lihat, apa hasil dari kita melakukan X

Step 4 : oh, ternyata X kurang efektif, coba kita ganti Y (back to step 1)

Selama belum ada evidence bahwa X efektif/tidak efektif maka jangan diubah dulu.

Art seperti ini : 

Step 1 : bangun pagi, coba dilihat apakah kita lagi mood melakukan X

Step 2 : gak mood, lakukan Y saja

Step 3 : hari ini selesai, kita lanjutkan besok (back to step 1, besok mungkin mood beda sehingga kita melakukan X)

Endy Muhardin
http://software.endy.muhardin.com

2013/5/4 Daud Mukadar <daudm...@gmail.com>