Dokumen Batal Tetap Acuan: Ekstraksi, Bukan Kebangkitan
Plan yang dibatalkan tetap bisa menjadi sumber panduan: ekstraksi eksplisit dengan daftar dilarang diangkat, sementara dokumen sumber tetap beku.
Ringkasan
Dokumen plan yang udah di-cancel hampir dianggap sampah padahal isinya masih kepake banget. Daripada buka lagi dokumen lamanya atau nyomot diam-diam, tim cuma mindahin yang masih valid ke bagian E di dokumen baru lengkap sama daftar yang dilarang dibawa. Jadi plan lama tetap beku cuma dikasih backlink, jejak keputusannya aman tapi ilmunya tetap bisa dipake.
Saat satu tinjauan teknis, sebuah dokumen plan implementasi berstatus cancelled hampir masuk daftar "beban usang" yang boleh diabaikan. Masalahnya, separuh detail implementasinya masih jadi jawaban terbaik untuk kebutuhan yang sedang berjalan: skema penyimpanan, hook riwayat, sampai kerangka estimasi.
Kiraan pertama: dokumen batal ya dibuka lagi saja, atau potongan yang masih bagus disalin diam-diam ke dokumen baru. Keduanya jelek dengan cara berbeda. Membuka ulang dokumen bekannt merusak fungsi rekamnya; penyalinan diam-diam menyelundupkan persyaratan lama yang mungkin sudah tergantikan.
Yang dipakai justru keduanya sekaligus, tapi dalam bentuk yang rapi. Plan v1 tetap cancelled, badannya tidak disentuh. Panduan yang masih sah diekstraksi secara eksplisit menjadi satu bagian baru di dokumen respon yang hidup: bagian E, berisi enam butir acuan (E1 sampai E6), lengkap dengan daftar "dilarang diangkat" untuk butir plan v1 yang sudah tersubstitusi spec v2. Plan bekannt hanya dapat satu hal: tautan balik di frontmatter.
Ekstraksi terkontrol, bukan kebangkitan
Pola ini mengikuti konvensi siklus hidup dokumen yang sudah dibahas sebelumnya: dokumen beku tidak pernah diedit, dan bila ada revisi, sistem membuat dokumen baru [1]. Ekstraksi bagian E adalah sisi hidup dari aturan itu. Alih-alih menghidupkan kembali dokumen lama, isinya yang bernilai dipindahkan ke dokumen yang memang boleh berubah.
Daftar "dilarang diangkat" adalah komponen yang paling sering dilewatkan. Tanpa daftar itu, ekstraksi berjalan dua arah: butir usang ikut terseret masuk, lalu beberapa pekan kemudian muncul lagi sebagai "kebutuhan" yang sudah pernah dibahas tuntas. Dengan daftar itu, status tiap butir tegas. Yang boleh dipakai disebut di E1 sampai E6, yang tidak boleh disertai alasannya, dan yang tidak disebut berarti memang tidak dievaluasi.
Dua skenario yang tidak setara
Uji dengan dua pilihan yang tersedia saat itu. Membuka kembali plan: semua informasi berkumpul di satu tempat, tetapi jejak keputusan hilang, dan tim baru tidak bisa melihat bahwa fitur itu pernah dipertimbangkan lalu ditinggalkan dengan alasan tertentu. Membiarkan plan utuh dan menautkan panduannya ke dokumen aktif: pembaca harus membuka dua dokumen, tetapi jejak auditnya jelas, evolusi keputusannya terbaca, dan dokumen lama tetap dapat dipercaya sebagai rekaman.
Biaya membuka dua dokumen jauh lebih murah daripada biaya tidak dapat mempercayai arsip. Itu sebabnya pilihan jatuh pada ekstraksi: bagian E hidup di dokumen respon, plan beku cukup menerima backlink.
Rekam tambang, jangan buka lubangnya
Dokumen yang sudah digantikan posisinya bukan makam; ia tambang. Nilainya dapat diambil penuh, asalkan penambangannya lewat daftar pengambilan yang eksplisit di dokumen yang memang hidup. Lubang tambangnya dibiarkan tertutup, karena fungsi terbesar sebuah dokumen bekannt justru menjadi bukti bahwa keputusan pembatalannya pernah dipikirkan.