Berikan identitas pada setiap artefak
Tulis nama studi, penanda versi, dan pertanyaan yang sedang dibahas. Penanda sebaiknya cukup sederhana untuk dipakai secara konsisten. Jika sebuah gambar menggantikan versi sebelumnya, jelaskan hubungan keduanya. Jangan hanya menamai berkas final tanpa menunjukkan statusnya dalam proses. Sertakan keterangan apakah gambar merupakan sketsa fungsi, model representasi, atau ilustrasi suasana. Perbedaan jenis artefak menentukan apa yang layak disimpulkan oleh pembaca ketika melihat dokumen tanpa penjelasan langsung dari pembuatnya.
Simpan alasan di dekat keputusan
Catatan alasan lebih mudah ditemukan jika berada bersama bagian yang diterangkannya. Gunakan kalimat singkat yang menghubungkan perubahan dengan kebutuhan atau pengamatan. Pisahkan fakta, dugaan, dan keputusan sementara melalui label yang jelas. Jika masukan berasal dari percakapan, ringkas konteksnya tanpa mengumpulkan informasi pribadi yang tidak dibutuhkan. Dokumentasi tidak harus menyimpan semua komentar. Pilih bagian yang membantu memahami jalan keputusan, termasuk keberatan yang belum terjawab dan alternatif yang mungkin perlu ditinjau kembali nanti.
Susun jalur baca bagi penerus
Mulailah paket catatan dengan ringkasan tujuan, lalu hubungkan ke gambar dan pengamatan yang mendukungnya. Daftar pertanyaan terbuka membantu orang berikutnya menentukan pekerjaan yang masuk akal. Periksa apakah nama bagian konsisten di seluruh dokumen dan apakah setiap gambar memiliki konteks yang cukup. Hindari menjadikan tampilan yang rapi sebagai pengganti isi yang lengkap. Dokumentasi yang baik membuat seseorang dapat menjelaskan apa yang sedang dicoba, mengapa pilihan tertentu diambil, dan bagian mana yang masih memerlukan pengetahuan tambahan sebelum konsep dilanjutkan.
Pertanyaan di meja
Pilih satu gambar lama dan tulis keterangan yang membuat orang lain dapat memahami tujuan, status, serta batasnya tanpa bertanya kepada pembuatnya.