Saya percaya dengan dokumentasi apa pun bahwa pendekatan gesit itu bagus. Sekarang, ada beberapa kesalahpahaman di luar sana bahwa gesit berarti "tidak ada dokumentasi atau analisis sama sekali" tapi itu tidak terjadi. Hal-hal yang saya baca tentang lincah berkata, "gunakan apa yang berhasil." Saya menganggap itu berarti dokumen harus panjang dan detail sesuai dengan tugas.
Templat dapat membantu sebagai daftar periksa, tetapi saya tidak akan meminta setiap bagian diisi untuk perubahan kecil atau berisiko rendah. Untuk perubahan satu baris, mungkin Anda tidak memerlukan dokumen sama sekali. Saya tidak pernah menggunakan templat untuk dokumen analisis dampak, tetapi saya secara teratur menangani persyaratan bisnis atau spesifikasi teknis. Templat bisa terlalu membatasi; pedoman yang baik adalah untuk mempertimbangkan siapa yang akan menjadi penonton. Jika itu untuk manajer yang tidak teknis, fokus pada justifikasi bisnis untuk perubahan. Jika ini untuk orang-orang teknis, berikan sedikit latar belakang sehingga orang baru dalam tim tidak akan hilang dan memberi mereka cukup untuk maju jika mereka harus mendukung perubahan. Juga, jika Anda menginginkan sesuatu yang bahkan lebih sedikit gesekan dan ringan, jangan gunakan dokumen sama sekali, letakkan di wiki.
Informasi termasuk:
- Deskripsi singkat masalah
- Jelaskan atau perlihatkan contoh bagaimana cacat menyebabkan kegagalan dan / atau ketidakefisienan
- Sertakan perkiraan kompleksitas
- Sertakan perkiraan biaya dan waktu untuk perbaikan
Itu minimum yang layak. Posting lain menyoroti beberapa hal CMMi yang cukup berat dari IBM; itu bagus jika Anda punya waktu dan sumber daya untuk itu (dan ketika Anda sedang membangun sistem untuk NASA di mana kehidupan manusia dipertaruhkan, maka orang lebih baik serius tentang hal itu) tetapi untuk tim kecil Anda mungkin tidak perlu terlalu berat . Hati-hati dengan perkiraan, seperti biasa. Manajer cenderung berasumsi bahwa estimasi adalah yang sebenarnya.
Perhatikan bahwa ada bahaya dalam pendekatan gesit. Beberapa pengembang berpikir itu berarti, "tidak diperlukan dokumen, cukup mulai meretas" (yang mungkin oke dalam beberapa situasi). Juga, orang lain akan mengambil garis lintang diberikan tugas dan hanya menulis dokumen yang benar-benar jelek yang tidak benar-benar membantu (belum tentu OK dalam kebanyakan situasi). Sebagian masalahnya adalah bahwa menulis dengan baik membutuhkan usaha, keterampilan, dan waktu; kebanyakan dari kita kekurangan setidaknya dua hal;)
Saya selalu fokus pada dokumentasi karena itu membuktikan Anda setidaknya menaruh cukup pemikiran untuk memenuhi syarat memiliki rencana. Tetapi di usia tua saya, saya juga menghargai bahwa terlalu banyak dokumentasi itu sendiri dapat menjadi masalah pemeliharaan, dan tidak cukup banyak orang yang cukup peduli untuk memperbarui dokumentasi.