👀 Aku membaca dokumentasi @BabylonLabs_io , berharap bisa langsung paham cara semuanya bekerja.
Tapi kemudian aku tersandung komentar-komentar yang campur aduk... dan entah kenapa catatan-catatan kecil itu malah jadi bagian paling menarik. 😂
Seperti, okay... komentar orang yang menulis "cuma untuk sementara" kadang mengungkap lebih banyak tentang sebuah sistem daripada dokumentasi yang sudah dipoles.
Ini yang sebenarnya diungkap oleh jenis audit seperti ini:
Utang Teknis Tersembunyi Komentar TODO fix this later yang tak pernah dibereskan. Ada yang tahu, lalu ada yang pindah ke hal lain.
Kekhawatiran Soal Maintainability Catatan yang ditinggalkan dev untuk masa depannya (atau masa depan orang lain) tentang bagian yang rapuh atau membingungkan untuk disentuh.
Indikator Risiko Masa Depan Komentar sepintas yang menandai asumsi yang hanya berlaku untuk saat ini—hal-hal yang diam-diam jadi masalah nanti.
Poin Gesekan Arsitektur Di mana komponen tidak benar-benar saling pas satu sama lain, dan seseorang meninggalkan komentar alih-alih melakukan perbaikan.
Intinya: hal-hal yang berbau "miscellaneous" itu sebenarnya bukan hal yang sembarangan. Itu semacam catatan harian engineering yang tidak dibaca siapa pun.
#baby $BABY
Tapi kemudian aku tersandung komentar-komentar yang campur aduk... dan entah kenapa catatan-catatan kecil itu malah jadi bagian paling menarik. 😂
Seperti, okay... komentar orang yang menulis "cuma untuk sementara" kadang mengungkap lebih banyak tentang sebuah sistem daripada dokumentasi yang sudah dipoles.
Ini yang sebenarnya diungkap oleh jenis audit seperti ini:
Utang Teknis Tersembunyi Komentar TODO fix this later yang tak pernah dibereskan. Ada yang tahu, lalu ada yang pindah ke hal lain.
Kekhawatiran Soal Maintainability Catatan yang ditinggalkan dev untuk masa depannya (atau masa depan orang lain) tentang bagian yang rapuh atau membingungkan untuk disentuh.
Indikator Risiko Masa Depan Komentar sepintas yang menandai asumsi yang hanya berlaku untuk saat ini—hal-hal yang diam-diam jadi masalah nanti.
Poin Gesekan Arsitektur Di mana komponen tidak benar-benar saling pas satu sama lain, dan seseorang meninggalkan komentar alih-alih melakukan perbaikan.
Intinya: hal-hal yang berbau "miscellaneous" itu sebenarnya bukan hal yang sembarangan. Itu semacam catatan harian engineering yang tidak dibaca siapa pun.
#baby $BABY