TEKNIK DOKUMENTASI APLIKASI RESUME : 5

TEKNIK DOKUMENTASI APLIKASI

RESUME : 5

Disusun Oleh :

Farah Priminta Arumsari                (10410110009)

S1 KOMPUTERISASI AKUNTANSI

Dosen Pembina : Ayuningtyas, S.Kom., M.MT

SEKOLAH TINGGI

MANAJEMEN INFORMATIKA DAN TEKNIK KOMPUTER

SURABAYA

2013

Pentingnya Tahap Investigasi Terhadap User

            Fungsi dokumentasi antara lain:

1.        Untuk membantu user dalam mempelajari software.

2.        Mengurangi biaya pendukung.

3.        Menjadi alat marketing perusahaan pembuat software.

4.        Image perusahaan software meningkat.

Tahap investigasi adalah tahap dimana ide-ide berkembang dan antara dokumentasi dengan subjek dapat menyatu. Investigasi terhadap user harus dilakukan secara benar agar menghasilkan dokumentasi yang baik. Siapa yang akan membaca buku/dokumentasi dan apa tugas yang dikerjakan perlu diperhatikan. Memulai investigasi dapat dilakukan dengan cara:

1.        Menginvestigasi dari awal hingga akhir kerja sistem.

2.        Memikirkan kesulitan dan kemudahan suatu sistem.

3.        Sebisa mungkin melihat dari sisi pengguna, bukan dari pembuat sistem.

Macam-macam User

            Dalam mengkategorikan user, salah satunya adalah dengan cara melihat jenis pekerjaannya. Pembuat dokumentasi harus mengkategorikan user karena membantu penulis dalam membuat dokumentasi yang dapat diaplikasikan sesuai kebutuhan user dan jenis pekerjaan user menunjukkan kemampuan atau level dari user. Macam-macam user dapat dibagi menjadi:

1.        Manager dan System Evaluator.

Untuk user ini, dokumentasi yang digunakan adalah Functional System Description, yaitu dokumentasi yang secara singkat menggambarkan kebutuhan sistem untuk menjalankan program, servis yang dimiliki aplikasi, dan gambaran umum aplikasi.

2.        System Administrator.

Untuk user ini, dokumentasi yang digunakan adalah Installation Document, yaitu dokumentasi yang menyediakan informasi mendetail bagaimana cara meng-install sistem di lingkungan sistem yang spesifik, mencantumkan gambaran file apa yang membentuk suatu aplikasi, dan cara mengkonfigurasi aplikasi agar berjalan dengan sistem yang ada.

3.        Novice User

Untuk user ini, dokumentasi yang digunakan adalah Introductory Manual, yaitu dokumentasi yang menyediakan pengenalan tentang sistem yang menggambarkan penggunaan umum dari aplikasi tersebut, menjelaskan cara mulai menggunakan program, dan mencantumkan kesalahan-kesalahan umum yang dilakukan oleh user serta cara menyelesaikannya.

4.        Experience User

Untuk user ini, dokumentasi yang digunakan adalah System Reference Manual, yaitu dokuementasi yang menjelaskan semua kegunaan dan fungsi yang dimiliki sistem/aplikasi, menggunakan bahasa yang resmi dan teknis, dan mencantumkan secara lengkap fitur dan cara operasional dari sistem/aplikasi.

Sumber :

Perkuliahan Teknik Dokumentasi Aplikasi pertemuan ke-5

http://www.google.com/url?sa=t&source=web&cd=1&ved=0CCgQFjAA&url=http%3A%2F%2Fbintarmadayraditya.files.wordpress.com%2F2012%2F02%2Fdokumentasi-software.pdf&ei=tGVTUvT2KMXQrQfc84HACg&usg=AFQjCNGvAnB6caSFJ87NGu4dWLWrVYcrQA

TEKNIK DOKUMENTASI APLIKASI RESUME : 4

TEKNIK DOKUMENTASI APLIKASI

RESUME : 4

Disusun Oleh :

Farah Priminta Arumsari                (10410110009)

S1 KOMPUTERISASI AKUNTANSI

Dosen Pembina : Ayuningtyas, S.Kom., M.MT

SEKOLAH TINGGI

MANAJEMEN INFORMATIKA DAN TEKNIK KOMPUTER

SURABAYA

2013

Product Documentation

            Tipe-tipe dokumentasi dan cara pemilihan tipe dokumentasi disesuaikan dengan kebutuhan aplikasi. Dokumentasi produk adalah dokumentasi yang menggambarkan hasil produk software. Ada dua kategori dokumentasi produk, yaitu dokumentasi user dan dokumentasi sistem. Pembuat dokumentasi harus dapat membedakan setiap user yang akan menggunakan sistem sesuai dengan level pengetahuan dan pengalaman agar user lebih mudah menggunakan sistem tersebut.

Buku Panduan Pengenalan

            Buku panduan pengenalan adalah buku petunjuk yang menggambarkan tentang proses, cara atau perbuatan mengenali sesuatu.

Buku Panduan Pelatihan

Buku panduan pelatihan adalah buku petunjuk yang menjelaskan tentang proses, cara dari kegiatan atau pekerjaan melatih. Suatu buku dapat dikategorikan sebagai buku panduan pelatihan karena di dalam buku tersebut dijelaskan dengan menggunakan langkah-langkah (tutorial) dari pelatihan sesuatu dan disertai gambar-gambar.

Buku Panduan Pengguna

Buku panduan pengguna adalah buku petunjuk yang mendeskripsikan tentang proses suatu kegiatan yang ditujukan bagi seorang pengguna kegiatan tersebut. Suatu buku dapat dikategorikan sebagai buku panduan pengguna karena di dalam buku tersebut dijelaskan dengan menggunakan pengertian atau definisi dari istilah-istilah yang ada serta langkah-langkah (tutorial) pembuatan sistem beserta gambar.

Buku Reference

            Buku referensi (reference) merupakan suatu buku acuan, rujukan, atau petunjuk. Menurut Trimo (1997) buku referensi adalah suatu buku atau sejumlah publikasi kepada siapa orang berkonsultasi untuk mencari fakta-fakta atau informasi tentang latar belakang suatu objek, orang, dan atau peristiwa secara cepat dan mudah. Pengertian lain dari buku referensi yaitu buku teks yang mengandung informasi yang dibatasi oleh tujuan-tujuan yang ingin dicapai dan biasanya ditulis komprehensif dilengkapi dengan indeks-indeks alfabetis sehingga orang mudah dan cepat mencari data yang dibutuhkannya.

            Contoh buku referensi, antara lain:

1.        Kamus dan Peta

2.        Ensiklopedi

3.        Handbook

4.        Direktori

5.        Guidebooks

6.        Buku Biografi

7.        Buku Indeks dan Abstrak

Struktur Berbasis Tugas

            Struktur yang berbasis tugas merupakan penghubung suatu sistem dengan sistem lain yang berdasarkan tanggung jawab atau kebutuhan yang telah ada.

Sumber :

Perkuliahan Teknik Dokumentasi Aplikasi pertemuan ke-4

http://www.artikata.com/arti-367961-pengenalan.html

http://elib.unikom.ac.id/gdl.php?mod=browse&op=read&id=jbptunikompp-gdl-ubudiyahse-15159

http://www.artikata.com/arti-347272-referensi.html

http://www.artikata.com/arti-370061-pelatihan.html

http://www.artikata.com/arti-364696-pengguna.html

TEKNIK DOKUMENTASI APLIKASI RESUME : 3

TEKNIK DOKUMENTASI APLIKASI

RESUME : 3

Disusun Oleh :

Farah Priminta Arumsari                (10410110009)

S1 KOMPUTERISASI AKUNTANSI

Dosen Pembina : Ayuningtyas, S.Kom., M.MT

SEKOLAH TINGGI

MANAJEMEN INFORMATIKA DAN TEKNIK KOMPUTER

SURABAYA

2013

Kategori Proses Pembuatan Dokumentasi Aplikasi

Proses Dokumentasi dibagi menjadi 5 kategori,yaitu :

1.        Plans, estimates, and schedules, adalah dokumen yang dibuat oleh manager yang digunakan untuk memperkirakan dan mengatur proses software.

2.        Report, dokumen yang menginformasikan bagaimana sumber daya digunakan saat proses pengembangan.

3.        Standart, dokumen yang menjelaskan bagaimana proses situ berjalan.

4.        Working papers, merupakan bagian terpenting dari dokumen dalam sebuah proyek, karena mencatat ide-ide para pekerja dan mencatat masalah yang ada dalam sebuah proyek.

5.        Memos and electronic mail messages, berisi detail percakapan antara manager dan pekerja.

Standar Dokumentasi IEEE tidak hanya standar yang ada, ada standar lain yang biasanya digunakan: Proses Standar, proses yang harus diikuti untuk membuat dokumen yang baik. Proses standar merupakan langkah penting dalam pembuatan suatu dokumen. Dalam proses standar terdapat rancangan pembuatan dokumen dengan software tertentu agar dapat menghasilkan dokumen yang baik. Proses dokumentasi harus fleksibel dan dapat mencakup beberapa tipe dokumen. Misalnya sebuah memo. Rancangan, pengecekan, pembetulan, dan pengecekan ulang adalah proses yang harus dilalui agar dokumen dapat di produksi.

            Karakteristik utama dari dokumentasi proses adalah hampir semua akan mengalami kadaluarsa. Banyak informasi yang akan terbuang dan tidak berguna apabila sistem telah jadi. Namun, apabila terdapat perubahan sistem, ada beberapa dokumentasi yang masih dibutuhkan seperti hasil testing dan lembar kerja yang mencatat alasan mengapa suatu desain dipilih dalam pembuatan software.

Sumber :

http://www.heyindonesia.com/2012/04/rangkuman-dokumentasi-softwareteknik.html

http://www.google.com/url?sa=t&source=web&cd=1&ved=0CCgQFjAA&url=http%3A%2F%2Fbintarmadayraditya.files.wordpress.com%2F2012%2F02%2Fdokumentasi-software.pdf&ei=tGVTUvT2KMXQrQfc84HACg&usg=AFQjCNGvAnB6caSFJ87NGu4dWLWrVYcrQA