Dokumentasi Proses
Kategori dokumen. Kebutuhan Dokumen:
A. Persyaratan umum semua dokumentasi perangkat lunak
· Harus menyediakan komunikasi antara anggota tim
· Harus bertindak sebagai penyimpanan informasi yang akan digunakan oleh teknisi pemeliharaan
· Harus menyediakan informasi yang cukup untuk manajemen untuk memungkinkan mereka untuk melakukan semua kegiatan pengelolaan program yang terkait
· Harus menjelaskan kepada pengguna bagaimana untuk mengoperasikan dan mengelola sistem
-Dalam semua proyek perangkat lunak beberapa jumlah dokumentasi harus dibuat sebelum kode yang ditulis. Ex: Rancangan dokumen, dll
-Dokumentasi harus dilanjutkan setelah kode telah selesai. Ex: Manual pengguna, dll
-Dua jenis utama dari dokumentasi dibuat adalah Proses dan Produk dokumen.
-Kualitas Dokumen: Menyediakan dokumentasi menyeluruh dan profesional adalah penting untuk setiap ukuran tim pengembangan produk. Masalahnya adalah bahwa banyak perangkat lunak profesional tidak memiliki keterampilan menulis untuk membuat dokumen tingkat profesional
Proses Dokumentasi:
-Proses dokumentasi akan menghasilkan software artifak. Software artifak yaitu segala sesuatu dari software (model/deskripsi) yang dikembangkan dan dipakai selama pengembangan dan pemeliharaan software.
- Contoh spesifikasi requirement, arsitektur, dan desain model. Dokumentasi ini dibuat untuk memungkinkan adanya keberhasilan pengelolaan produk perangkat lunak. Dibagi menjadi 5 kategori:
1. Perencanaan, estimasi, penjadwalan: diproduksi oleh para manajer yang digunakan untuk memproduksi dan mengontrol proses software-nya. Di buku lain disebutkan ada project management documents, perencanaan proyek, jadwal proyek, dan model laporan yang lain, ex: laporan rapat
2. Laporan: bagaimana sumberdaya digunakan selama proses pengembangan, seperti laporan project regular
3. Standar: Standar memainkan peran penting dalam pengembangan, pemeliharaan dan kegunaan dokumentasi. Standar dapat bertindak sebagai dasar untuk dokumentasinya berkualitas. Tetapi tidak cukup baik pada mereka sendiri. Biasanya menetapkan konten tingkat tinggi dan organisasi. contohnya seperti: CSC, IEEE / EIA 12207 0-1996, software life circle, IEEE / EIA 12207 1-1997, life circle data, IEEE / EIA 12207 2-1997, implementation consideration
4. Kertas kerja: seringkali dari teknik prinsip komunikasi dokumen dari proyek, seperti: coret-coretan kerja. Yang merekam ide dan pemikiran pekerjaan engineer dalam suatu pengerjaan proyek. Berupa detil desain yang berisi analisis dan metodologi desain, yang berupa workflow.
5. Komunikasi: merupakan detil komunikasi tiap hari antara manajer dan karyawan dari teknik pengembang.
Karakteristik:
-Memiliki umur yang relatif pendek
-Hanya penting untuk proses pengembangan internal. Kecuali dalam kasus di mana pelanggan membutuhkan pandangan ke data.
-Beberapa item, seperti kertas yang menggambarkan keputusan desain harus digali dan dipindahkan ke dalam kategori dokumentasi produk ketika mereka menjadi diimplementasikan
-Karakteristik yang umum dari dokumentasi adalah pasti akan kadaluarsa .
-Perencanaan biasanya dibuat secara mingguan / bulanan. Laporan progress-nya juga dilaporkan
-Software historian sedikit sekali penggunaannya yang kadaluarsa dan tidak bisa membuat, menyimpan setelah sistem dihasilkan
-Untuk proyek internal, untuk mengurangi jumlah proses dokumentasi. untuk orang luar, harus dibuatkan dokumentasi yang benar yaitu kontrak antara pelanggan dan pemasok, yang berisi dokumentasi apa saja yang dihasilkan.
- Tim pengembang juga membutuhkan evidence (catatan kecil) sebagai bukti pembuatan software. Dan the regulatory requirements yaitu proses mendapatkan sertifikasi.
Sumber Pustaka:
Catatan Materi Kuliah TDA pert 3
http://www.eecs.ucf.edu/~turgut/COURSES/EEL6883_SEII_Spr07/PaperPresentations/Sommerville-p143.ppt
http://www.literateprogramming.com/documentation.pdf
-Thanks to Google Translate -
By: Azid Malil'ula Wildan M (10410110014)-S1 Komputerisasi Akuntansi
No comments:
Post a Comment