Dokumentasi
Dokumentasi
Adang Suhendra
1
Dokumentasi
Salah satu kebutuhan manajemen pengembangan sistem/software Salah satu media yang merekam kebutuhan user yang akan diimplementasikan dalam bentuk spesifikasi dan instruksi
Perencanaan
Organisasi
Pendefinisian
Tertuang dalam suatu Statement of Work (SOW) yang terdiri dari:
Pengantar Tujuan dan obyektif Scope Asumsi User Sumber Daya Milestone untuk penjadualan Pembiayaan Amandemen Tanda tangan
4
Tujuan SOW
Menjelaskan biaya dan jadual serta asumsi utama proyek. Menjelaskan peranan dan tanggung jawab. Mengukuhkan definisi hal yang akan dicapai proyek. Mendorong diselesaikannya proyek tersebut, karena adanya kesepakatan tertulis dalam dokumen tersebut.
5
Perencanaan
Menyusun Work Breakdown Structure(WBS)
Daftar rencana kerja yang tersusun berdasarkan dekomposisi fungsional sistem Dasar estimasi: alokasi sumber daya, penyusunan jadual, perhitungan biaya. Pertimbangan pelaksanaan projek.
Perhitungan Biaya
Biaya dibandingkan dengan yang ada di SOW
Jadual Kerja
Bart Chart Network Diagram (PERT)
Penentuan Resiko
Menentukan kemungkinan risiko serta dampak dari risiko tersebut proses kritis
7
Organisasi
Struktur Team
Peran, tanggung jawab, hubungan pelaporan
Dokumentasi
Perangkat dokumen teknis seperti Manual online, laporan status dan jadual
Pertemuan
Status review meeting, Checkpoint review meeting, Staff meeting.
8
Pengawasan
Status Collection dan Assessment
Data tentang progres pekerjaan menuju milestone
Change Control
Evaluasi pelaksanaan teknis dan jadual, yang meliputi: perubahan yang terjadi, dampak finasial, cara penanganan, dampak.
Corrective Action
Revisi pedekatan yang dilakukan untuk pencapaian tujuan sesuai SOW
9
Penyelesaian Proyek
Laporan transisi dari perancangan ke implementasi Identifikasi unjuk kerja proyek (tingkat keberhasilan yang dicapai) Menggambarkan tendensi antar personal yang terlibat
10
Leading
Membuat visi proyek yang jelas Efektifitas komunikasi. Menjaga motivasi yang tinggi Menjaga fokus dan visi. Menyediakan lingkungan yang mendukung. Mendorong penyusun team.
11
2. Proposal
13
4. Estimasi
Jadwal Staf dan Organisasi Budget Analisis Cost/Benefit Analisis resiko Dokumen yang diberika Perangkat lunak yang dibutuhkan Fasilitas dan perangkat keras yang dibutuhkan
14
5. Prosedur
Model Proses Metodologi dan notasi Standardisasi dan jaminan kualitas Accountability monitoring Kendali produk Data pengujian dan sumber data Kriteria akseptansi dan metoda pembayaran
6. Referensi
Dokumentasi yang digunakan dalam pengembangan Kamus istilah Kontrak yang diusulkan
15
2. Spesifikais singkat
Spesifikasi interaksi manusia dan mesin yang digunakan Batasan Eksepsi Modifikasi dan perawatan yang digunanakan.
3. Disain Arsitektur
Modul hirarki dan diagram interface Deskripsi fungsi dan data Spesifikasi interface
17
5. Referensi
Dokumentasi yang digunakan untuk mengembangkan disain Daftar terminologi
18
1.3 Model Kebutuhan Disusun secara hierarki (functional) berdasarkan prioritas, risk functional,
2. Spesifikasi
2.1 Spesifikasi siklus operasi sistem 2.2 Spesifikasi fungsional
Essential capabilities Additional Capabilities Future Capabilities
2.3 Komponen Sistem Komponen yang dibutuhkan oleh sistem (software, hardware, dan organisasi penunjang)
20
3. Disain
3.1 Disain Sistem Utama
Diagram Blok Aliran kontrol Representasi aliran data Dekomposisi ke dalam fungsi-fungsi Hubungan antar fungsi-fungsi Spesifikasi Modul
21
22
5. Pengujian (testing)
Melakukan Verifikasi dan Validasi. Recovery testing Stress testing Security testing
23
User Manual
1. Pengantar
Tujuan dari produk Lingkungan operasi Fungsi secara umum Fitur Khusus Ketrbatasan Keterangan dan notasi dokumen
24
2. Instalasi
Persyaratan minimal sistem yang dibutuhkan Menyalin dan memback-up Proses instalasi Konfigurasi/kustomisasi produk
3. Tutorial
Penjelasan langkah-demi langkah dengan contoh Penjelasan tiap contoh Pengembangan dari contoh dasar Penggunaan on-line Help
25
4. Instruksi detail
Keluaran dari produk Masukan untuk produk Pengoperasian produk Penanganan error Fungsi khusus
5. Detail Teknis
Prinsip dari operasi Fitur lanjutan Algoritma utama yang digunakan Struktur data utama Modifikasi produk Cara memperoleh dukungan teknis dan informasi lanjutan
26
Dokumentasi Maintenance
Menjelaskan tata cara perawatan dan pengelolaan sistem yang baik.
Maintenance Manual Trouble shooting manual Tingkat kerusakan uang ditulis biasanya hanyalah sampai pada level yang ringan dan tak perlu penanganan khusus.
27
29
30
Dokumentasi Testing
Identifier. Spesifikasi Kebutuhan. Metodologi verifikasi kode. Metodologi verifikasi disain. Rencana Pengujian Fitur dan sisi yang diujikan Personal yang bertanggung jawab serta jadual Perangkat bantu dan program bantu yang digunakan 31
Data pengujian dan instruksi pengujian Hasil pengujian yang diharapkan Hasil pengujian sesungguhnya, serta analisis.
32
Standard Dokumentasi:
Dokumentasi Software Development Plan (IEEE Standard 1058.1 1987) Dokumentasi Software Requirements Specification (IEEE Standard 830 1993) Dokumentasi Software Design Specification (IEEE Standard 1016 1987) Dokumentasi Software Testing (IEEE Standard 829 1983) Dokumentasi Software User Documentasi (IEEE Standard 1063 1987)
33