Dokumentasi, serah terima, dan dampak sumber daya
INFO9-31
Menyusun petunjuk yang dapat diikuti orang lain serta menilai kebutuhan pemeliharaan.
Bekal awal: Memahami versi, cadangan, dan batas produk.
Konteks bab
Evaluasi pekerjaan pada PDF133 menjadi konteks menelusuri sebab dan perbaikan. Semua data proyek disusun sebagai simulasi.
Bacaan dan kasus
8 · Total yang belum lengkap
Bacaan pendalaman
Kasus dan angka yang dibuat untuk latihan adalah simulasi/rekaan; fakta konsep dan sumber dibedakan dalam uraian.
Empat catatan rekaan memuat A01 total10 dipinjam4, A02 total6 dipinjam6, A03 total5 dipinjam2, dan A04 total2 dipinjam3. Program menampilkan sisa6,0,3 lalu menolak A04. Jumlah yang sah adalah9, tetapi label awal berbunyi “total seluruh persediaan”.
Pemeriksa mengusulkan label “total sisa dari tiga baris valid:9; satu baris perlu diperiksa”. A04 tidak diubah diam-diam menjadi2 dipinjam2. Data awal disimpan agar sumber masalah dapat ditelusuri. Kelompok juga memastikan angka0 pada A02 tetap masuk sebagai data sah.
Portofolio akhir memuat kontrak, jejak validasi, laporan, uji, dokumentasi, serta revisi label. Setiap anggota menjelaskan satu kasus baru dan mencatat bantuan. Program tetap diberi batas model pembelajaran; tidak diklaim siap mengelola transaksi pondok nyata. Kejujuran cakupan menjadi bagian mutu teknis.
Fokus pemeriksaan. Mengapa label hasil merupakan bagian ketepatan program?
Dokumentasi menjelaskan cara dan alasan
Petunjuk proyek memuat tujuan, kebutuhan lingkungan, cara menyiapkan data, menjalankan, membaca hasil, serta menangani kesalahan yang diperkirakan. Tambahkan contoh kecil dengan keluaran yang benar. Nama berkas yang jelas dan nomor versi membantu pembaca menemukan bahan. Dokumentasi tidak cukup hanya menulis “jalankan seperti biasa”.
Serah terima mencakup hal yang belum selesai
Catat pembuat bagian, sumber aset, lisensi, bantuan, uji yang sudah dilakukan, kendala, dan rencana berikutnya. Berkas rekaan dapat disalin untuk penerima mencoba pemulihan. Jika ada bagian belum dipahami pembuat, nyatakan agar tidak diwariskan sebagai jaminan. Hasil kelompok tidak boleh menghapus kontribusi individu atau mengambil karya orang lain tanpa atribusi.
Produk mempunyai biaya sepanjang penggunaan
Waktu merawat data, memperbarui petunjuk, kapasitas penyimpanan, energi, serta perangkat perlu dipertimbangkan. Tidak semua kebutuhan memerlukan server atau aplikasi baru. Model lokal sederhana dapat cukup untuk tugas kecil, dengan batas akses dan cadangan yang jelas. Jangan mengklaim satu pilihan paling ramah lingkungan tanpa data; jelaskan asumsi dan ukuran yang belum diketahui.
Telusuri contoh
Apa yang perlu diketahui penerima selain kode?
- Tujuan, lingkungan, format data, cara menjalankan, keluaran contoh, uji, batas, dan lisensi.
- Catat cara pemulihan salinan.
- Uji petunjuk dengan orang yang tidak ikut membuat.
Apakah aplikasi baru selalu lebih efisien daripada tabel?
- Tidak.
- Pertimbangkan ukuran tugas, jumlah pengguna, pemeliharaan, dan sumber daya.
- Pilih menurut kebutuhan serta bukti, bukan kebaruan.
Serah terima bukan hanya mengirim kode; kebaruan teknologi tidak otomatis mengurangi semua biaya.
Latihan mandiri
1 Sebutkan empat isi dokumentasi.
Petunjuk awal
Pisahkan informasi yang diketahui, alasan yang diperlukan, dan batas kesimpulan. Periksa kembali contoh sebelum membuka pembahasan.
Pembahasan · buka setelah mencoba
Tujuan, lingkungan, masukan, langkah, contoh hasil, kesalahan, uji, versi, atau batas.
2 Mengapa hal belum selesai dicatat?
Petunjuk awal
Pisahkan informasi yang diketahui, alasan yang diperlukan, dan batas kesimpulan. Periksa kembali contoh sebelum membuka pembahasan.
Pembahasan · buka setelah mencoba
Agar penerima tidak menganggapnya sudah diperiksa atau aman digunakan.
3 Apa biaya selain pembuatan awal?
Petunjuk awal
Pisahkan informasi yang diketahui, alasan yang diperlukan, dan batas kesimpulan. Periksa kembali contoh sebelum membuka pembahasan.
Pembahasan · buka setelah mencoba
Pemeliharaan data, pembaruan, penyimpanan, energi, perangkat, serta waktu pengguna.
4 Mengapa klaim lingkungan perlu data?
Petunjuk awal
Pisahkan informasi yang diketahui, alasan yang diperlukan, dan batas kesimpulan. Periksa kembali contoh sebelum membuka pembahasan.
Pembahasan · buka setelah mencoba
Dampak bergantung penggunaan, perangkat, sumber energi, dan cakupan perbandingan.
Perluas pemahamanmu
Bandingkan tiga pilihan: kartu kertas, tabel lokal, dan aplikasi model. Jelaskan kebutuhan, batas, serta biaya perawatan masing-masing tanpa angka pasar rekaan yang tidak dilabeli.
Coba dengan umpan balik
Latihan otomatis membantu pemeriksaan; tuliskan alasan dan langkah untuk membuktikan pemahaman.
1 Dokumentasi yang berguna memungkinkan pembaca…
Petunjuk awal
Tentukan informasi, konsep dan bukti yang dibutuhkan.
Pembahasan · buka setelah mencoba
C. menjalankan contoh dan memahami batasnya. Petunjuk menghubungkan cara penggunaan dengan bukti dan keterbatasan.
Praktik dan refleksi
Tulis petunjuk satu halaman dan minta teman mengikuti pada data model. Catat langkah yang membutuhkan penjelasan tambahan.
Penanda pribadi di perangkat ini; bukan nilai atau bukti penguasaan.