Teknik Dokumentasi Aplikasi (P2)

DOKUMENTASI dan KOMPONENNYA

Dokumentasi diperlukan pada saat tahap proyek. Dokumentasi akan memudahkan untuk pembuatan projek selanjutnya.

* Dokumentasi Perencanaan Proyek

- Pengantar :

Deskripsi masalah, lingkungan masalah, tujuan client, organisasi dan system, solusi dan ruang lingkupnya.

- Proposal :

Isi dari proposal adalah solusi apa saja yang dikerjakan? User dan hardwarenya bagaimana? Keuntungan dan kerugiannya bagaimana ?

- Keterbatasan sistem :

Prioritas pelanggan , profil pengguna, usia pengharapan produk (dapat menyimpan data berapa Giga/ Tera), prasayarat kendala (apa mereka dapat menggunakan VB.net? atau hanya sekedar Ms.Word dan Ms. Excel?), kinerja (mereka dapat mengerjakannya atau tidak? Professional atau bias sedikit – sedikit?), solusi alternative, solusi feasible, ketersediaan pada lingkungan pengguna.

- Estimasi :

 Persiapannya butuh berapa lama? Dan harus sesuai dengan projek yang di kerjakan. Misal :  estimasi waktu
mengerjakan projek menggunakan Ms.Office tidak boleh sama dengan mengerjakan program menggunakan VB.NET?. hal ini dapat membuat pembuatan projek menjadi molor.

Kita harus mengelola jadwal seminimal mungkin dan seefektif mungkin.

Antara staf dan organisasi harus ada pembagian job yang jelas.

Budget harus di tentukan sematang mungkin dan kemungkinan resiko yang terjadi.

Kelebihan dan kekurangan (Cost / Benefit). Analisa resiko harus dapat dimimalisasi.

Dokumen yang diberikan apa saja? Seperti surat, proposal, laporan dll. Perangkat lunak apa saja yang dibutuhkan (aplikasi). Dan Perangkat keras apa saja yang dibutuhkan. Contoh : Jaringan, computer, server dll.

- Prosedur :

Pada model proses dicek jangan sampai ada yang salah.

Metodologi yang digunakan apa saja?

Standarisasi dan jaminan kualitas.

Data pengujian dan sumber data.

Kriteria dan akseptasi dan metoda pembayaran.  

- References :

Dokumentasi harus sesuai dengan aplikasi. Kamus istilah untuk mencari data jangan terlalu ribet /ruwet agar dapat dicari.Kontrak yang diusulkan.

* Dokumentasi Spesifikasi Desain

Pendahuluan :

Garis besar permasalahannya seperti apa? Lingkungan aplikasi dan karakteristik pengguna seperti apa? Jangan sampai kita membuat projek dengan aplikasi yang kita kuasai adalah menggunakan VB.NET ternyata kita berada pada lingkungan aplikasi dan pengguna C++.

Notasi yang digunakan dalam projek, dan tujuan projeknya seperti apa?.

Spesifikasi singkat

Fungsi perangkat lunak, dan teknik penggunaan

Kinerja yang harus dicapai, spesifikasi yang real-time.

Desain arstitektur

Yang dibutuhkan dalam desain arsitektur adalah modul hirarki dan diagram interface. Deskripsi  fungsi data dan spesifikasi interface.

Desain secara detail

Lebih di deskripsikan yang ada dalam desain arsitektur. Seperti modul hirarki dan diagram interface. Deskripsi  fungsi data dan spesifikasi interface.

Referensi

Yang dibutuhkan untuk mengembangkan desain. Daftar terminology, daftar instalasi, spesifikasi penanganan eksepsi dan alternative desain.

 ============================= Progress ==============================