Mencoba sebuah tool Dusk yang hari ini merilis open source dan satu hasil membuatku kaget.
Pituitary, dibangun untuk menangkap ketika dokumen, spesifikasi, dan kode berhenti saling cocok. Arahkan ke sebuah repo, ia mengindeks spesifikasi dan decision records, lalu menandai perbedaan yang bertentangan dengan sesuatu yang sudah diterima. Aku menjalankannya pada sebuah test diff yang jelas-jelas merusak spesifikasi yang sudah ada.
Tidak gagal pada pengecekan itu. Kupikir itu bug.
Ternyata bukan. Tool ini mencari komentar rasional di dekat perubahan, WHY, HACK, semacam penanda itu. Kalau seseorang sudah menganotasi penyimpangan itu sebagai sesuatu yang disengaja, alurnya berbeda daripada drift yang tidak disengaja biasa.
Itulah pemisahan sebenarnya. Kontradiksi dan pelanggaran tidak sama di sini. Spesifikasi bilang satu hal, kode bilang hal lain—tetap akan dicatat, bukan gagal, kalau manusia sudah menjelaskan celah itu.
Spesifikasi ditulis dan diindeks, kode menyimpang, diff dijalankan melalui check-doc-drift, kontradiksi terdeteksi, tool mencari baris-baris di sekitarnya untuk penanda itu, penyimpangan yang disengaja mengikuti jalur tertentu, yang tidak dijelaskan gagal build.
Tapi tidak ada yang mengecek apakah penanda itu masih berarti apa-apa. Tidak ada yang menghentikan seseorang menulis WHY hanya untuk meredam bendera, dan tidak ada yang memeriksa apakah alasan asli di balik yang lama itu masih berlaku.
Apa yang terjadi pada konvensi itu di ratusan PR seminggu, begitu konvensi tersebut berdiri di antara sebuah regresi dan sebuah proses yang tenang? 👍
#dusk $DUSK @Dusk
Pituitary, dibangun untuk menangkap ketika dokumen, spesifikasi, dan kode berhenti saling cocok. Arahkan ke sebuah repo, ia mengindeks spesifikasi dan decision records, lalu menandai perbedaan yang bertentangan dengan sesuatu yang sudah diterima. Aku menjalankannya pada sebuah test diff yang jelas-jelas merusak spesifikasi yang sudah ada.
Tidak gagal pada pengecekan itu. Kupikir itu bug.
Ternyata bukan. Tool ini mencari komentar rasional di dekat perubahan, WHY, HACK, semacam penanda itu. Kalau seseorang sudah menganotasi penyimpangan itu sebagai sesuatu yang disengaja, alurnya berbeda daripada drift yang tidak disengaja biasa.
Itulah pemisahan sebenarnya. Kontradiksi dan pelanggaran tidak sama di sini. Spesifikasi bilang satu hal, kode bilang hal lain—tetap akan dicatat, bukan gagal, kalau manusia sudah menjelaskan celah itu.
Spesifikasi ditulis dan diindeks, kode menyimpang, diff dijalankan melalui check-doc-drift, kontradiksi terdeteksi, tool mencari baris-baris di sekitarnya untuk penanda itu, penyimpangan yang disengaja mengikuti jalur tertentu, yang tidak dijelaskan gagal build.
Tapi tidak ada yang mengecek apakah penanda itu masih berarti apa-apa. Tidak ada yang menghentikan seseorang menulis WHY hanya untuk meredam bendera, dan tidak ada yang memeriksa apakah alasan asli di balik yang lama itu masih berlaku.
Apa yang terjadi pada konvensi itu di ratusan PR seminggu, begitu konvensi tersebut berdiri di antara sebuah regresi dan sebuah proses yang tenang? 👍
#dusk $DUSK @Dusk
