TEKNIK DOKUMENTASI APLIKASI (pert - 2)

Resume TDA
pertemuan 2
Dosen : Ayuningtyas, S. Kom. M. MT


Dokumen Perencanaan Proyek (Project Plan)
detil yang menunjukkan strategi untuk dapat menyelesaikan proyek. Outline-nya bisa berupa tahapan-tahapan fase  dan langkah demi langkah kerja.

1.      Pengantar

•   Deskripsi masalah,

•   Deskripsi lingkungan masalah,

•   Tujuan client, organisasi dan sistem,

•   Solusi dan ruang lingkupnya.

2.      Proposal

•   Fungsi yang diberikan pada solusi yang diajukan.

•   Strategi umum untuk pengambangan solusi.

•   Peran pengguna dan perangkat keras pada solusi

•   Keuntungan dan kerugian solusi tersebut

3.      Keterbatasan Sistem (Constrain)

•   Prioritas customer

•   Profil penggunq

•   Usia pengharapan produk

•   Pra-syarat kendala (reliabilitas)

•   Pra-syarat kinerja

•   Solusi Alternatif

•   Solusi feasible

•   Ketersediaan pada lingkungan pengguna

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

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

Sumber : http://adang.staff.gunadarma.ac.id/Downloads/files/344/Dokumentasi.ppt

Dokumentasi Desain (Outline Spesifikasi Desain)

Konsep dan Prinsip Berorientasi Objek

Unified Modeling Language (UML) adalah himpunan struktur dan teknik untuk pemodelan desain program berorientasi objek (OOP) serta aplikasinya. UML adalah metodologi untuk mengembangkan sistem OOP dan sekelompok perangkat tool untuk mendukung pengembangan sistem tersebut.UML mulai diperkenalkan oleh Object Management Group, sebuah organisasi yang telah mengembangkan model, teknologi, dan standar OOP sejak tahun 1980-an. Sekarang UML sudah mulai banyak digunakan oleh para praktisi OOP. UML merupakan dasar bagi perangkat (tool) desain berorientasi objek dari IBM.

UML adalah suatu bahasa yang digunakan untuk menentukan, memvisualisasikan, membangun, dan mendokumentasikan suatu sistem informasi. UML dikembangkan sebagai suatu alat untuk analisis dan desain berorientasi objek oleh Grady Booch, Jim Rumbaugh, dan Ivar Jacobson. Namun demikian UML dapat digunakan untuk memahami dan mendokumentasikan setiap sistem informasi. Penggunaan UML dalam industri terus meningkat. Ini merupakan standar terbuka yang menjadikannya sebagai bahasa pemodelan yang umum dalam industri peranti lunak dan pengembangan sistem.

Sumber : http://ndahpuji.blogspot.com/2010/10/dokumentasi-desain-outline-spesifikasi.html

dokumentasi pengembangan sistem
Dokumentasi sistem adalah pendukung pengendalian. Pendukung pengendalian berupa pengembangan sistem. Format khusus dari dokumentasi pengembangan sistem biasanya di sebut dalam standar-standar dokumentasi pengembangan sistem organisasi.

		Contoh pengendalian-pengendalian dokumentasi dalam siklus hidup pengembangan sistem
Tahap						Dokumentasi
Perancangan dan analisis sistem						Studi kelayakan
						Diagram arus logis
						Kamus-kamus data
						Spesifikasi pemakai
						Perancangan konseptual
Perancangan sistem						Laporan perancangan sistem
						Bagan arus
						Tabel kepuusan
						Deskripsi program
						Prosedur-prosedur operasi
						Menjalankan manual
						Deskripsi file
						Prosedur-prosedur masukan data
Implementasi, evaluasi, dan						Perancanaan pengubahan
pengendalian sistem						Perancanaan pengujian
						Skedul operasi
Audit dan penelahaan sistem						Perencanaan audit
						Tanggapan pemakai

aisumber: http://auditsektorpublic.blogspot.com/2010/12/chapter-9pengembangan-sistem-suatu.html Dokumentasi_Mntenance •          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. Dokumentasi Source Code seorang programmer, yang menginginkan dokumentasi kode program yang anda buat, Doxygen merupakan salah satu tools yang dapat anda gunakan untuk menghasilkan dokumentasi secara otomatis. Doxygen dapat membuatkan dokumentasi kode program bahasa C++, C, Java, Objective-C, Python, IDL (Corba dan Microsoft flavors), Fortran, VHDL, PHP, C#, dan lainnya. Hasil dokumentasi yang dibuat oleh Doxygen dapat berupa html, LaTeX, serta beberapa format lainnya. Standar Dokumentasi Standar dokumentasi berbeda dengan standar proses pengembangan (SDLC). Semua pengembangan software, baik yang dilakukan oleh pihak internal maupun cara outsource harus membuat dokumentasi sesuai standar tersebut. Hal yang harus diingat adalah: Jangan membuat standar dokumentasi yang bentuknya tidak biasa. Saya sarankan untuk mengadopsi dari suatu standar, lalu lakukan penyesuaian minor. Untuk pemodelannya, saya menganjurkan untuk menggunakan UML secara penuh. Sumber : http://kupalima.wordpress.com/2008/04/02/standar-dokumentasi-pengembangan-software/