TEKNIK DOKUMENTASI APLIKASI S1 Sistem Informasi Kekhususan Komputerisasi Akuntansi

(1)

Mahasiswa telah memahami proses pembuatan aplikasi sistem informasi

Garis Entry Behavior [C2,A2]

Mahasiswa mampu menjelaskan pentingnya dokumentasi dalam proses pembuatan aplikasi sistem

informasi (1)

[C2,A2]

Mahasiswa mampu menjelaskan kegiatan yang harus dilakukan pada proses pembuatan dokumentasi aplikasi (2)

[C2,A2]

Mahasiswa dapat menjelaskan kategori-kategori dalam pembuatan

dokumen aplikasi (3) PROCESS DOCUMENTATION

CAPAIAN PEMBELAJARAN :

Mahasiswa mampu menjelaskan konsep, teknologi, teknik pembuatan dokumentasi aplikasi, serta mampu membuat dokumentasi aplikasi yang baik dan benar dengan menggunakan aplikasi yang tepat guna serta bertanggung jawab pada tugas yang diberikan. [C4,A4 ,P4]

Peta Capaian Belajar Mhs :

TEKNIK DOKUMENTASI APLIKASI, 410112030, 2, 7

[C2,A2]

Mahasiswa dapat menjelaskan tipe-tipe dokumentasi dan cara pemilihan tipe dokumentasi yang tepat sesuai kebutuhan

aplikasi. (4)

[C2,A2]

Mahasiswa dapat menjelaskan kebutuhan dokumentasi aplikasi

pada setiap user yang berbeda (5)

[C2,A2]

Mahasiswa dapat menjelaskan kebutuhan dokumentasi aplikasi pada system dalam setiap

tahapan pengembangan (6) PRODUCT DOCUMENTATION

[C3,A3 ,P3]

Mahasiswa dapat menerapkan model penulisan yang benar pada dokumentasi aplikasi

(7)

[C3,A3 ,P3]

Mahasiswa dapat menerapkan elemen-elemen grafik pada dokumentasi aplikasi (8)

[C3,A3 ,P3]

Mahasiswa dapat menerapkan standard dokumen pada pada dokumentasi aplikasi (9,10) DOCUMENT QUALITY

[C3,A3,P3]

Mahasiswa dapat menerapkan Tahapan penulisan pada dokumentasi aplikasi (11)

[C3,A3 ,P3]

Mahasiswa dapat menerapkan konsep dokumentasi online dalam pembuatan dokumentasi aplikasi (12)

[C4,A4 ,P4]

Mahasiswa mampu membuat dokumen aplikasi sesuai dengan standar IEEE untuk Software Documentation

(2)

MATA KULIAH KODE BOBOT SEMESTER Rumpun MK Direvisi

TEKNIK DOKUMENTASI APLIKASI 410112030 2 7 MKK 25 Juli 2013

Capaian pembelajaran Mahasiswa mampu menjelaskan konsep, teknologi, teknik pembuatan dokumentasi aplikasi, serta mampu membuat dokumentasi aplikasi yang baik dan benar dengan menggunakan aplikasi yang tepat guna.

Diskripsi Materi Matakuliah ini membahas tentang konsep, teknologi, teknik pembuatan dokumentasi aplikasi, serta mampu membuat dokumentasi aplikasi yang baik dan benar dengan menggunakan aplikasi yang tepat guna.

Pustaka Utama :

1. Baker, T. T. (2002). Writing Software Documentation: A Task-Oriented Approach, 2 editions. Longman.

2. Low, R., Ford, H., Pallot, J., & Hall, J. (1994). Writing User Documentation, a Practical Guide for those who want to be read. Hertfordshire: Prentice Hall International (UK).

3. Sommerville, I. (2010, March). Web chapters - Chapter 30: Documentation. Retrieved July 2013, from SOFTWARE ENGINEERING 9: http://ifs.host.cs.st-andrews.ac.uk/Books/SE9/index.html

4. Thirlway, M. (1994). Writing Software Manuals. Hertfordshire: Prentice Hall International (UK). Pendukung :

1. Hackos, Joann T. 1994. Managing Your Documentation Projects. Canada: John Wiley & Sons, Inc. 2. Horton, William. 1994. Designing & Writing OnLine Documentation. Canada: John Wiley & Sons, Inc.

3. IEEE Computer Society. (2001). 1063 IEEE Standard for Software User Documentation. New York: The Institute of Electrical and Electronics Engineers, Inc.

Team Teaching

-Assessment Quiz, UTS, Paper dan Presentasi (UAS) Matakuliah Syarat Testing dan Implementasi Sistem

Minggu

Ke- Sub-Kompetensi (Sub-LO)

Assessment Metode

Pembelajaran,

Estimasi Waktu,

Fasilitas Pembelajaran

Materi Pembelajaran

[Pustaka]

Indikator Bentuk Bobot

KONSEP DOKUMENTASI APLIKASI

1.

Mahasiswa mampu menjelaskan pentingnya dokumentasi dalam proses pembuatan aplikasi sistem informasi [C2,A2]

1. Ketepatan menjelaskan konsep dokumentasi aplikasi

2. Ketepatan mejelaskan pentingnya dokumentasi aplikasi

3. Ketepatan menjelaskan permasalahan dokumentasi yang terjadi pada proses

Resume dituliskan di blog, link dikirimkan maksimal M2 ke

email dosen

2.5%

1.Kuliah

[TM : 1(2x50)] 2.Membuat resume

perkuliahan [BT+BM : 1(2x50)] LCD Projector,

1. Penjelasan RPP

(3)

Minggu

Pembelajaran,

Estimasi Waktu,

[Pustaka]

dokumentasi aplikasi PC/Laptop, Sound

System

Buku Utama 4;ch 1 p.1-5 )

PROCESS DOCUMENTATION

2.

Mahasiswa mampu menjelaskan kegiatan yang harus dilakukan pada proses pembuatan dokumentasi aplikasi [C2,A2]

1. Ketepatan menjelaskan hubungan antara kebutuhan project dan system yang sedang dikembangkan

2. Ketepatan menjelaskan langkah-langkah pembuatan dokumentasi aplikasi

email dosen

2.5%

1.Kuliah

perkuliahan [BT+BM : 1(2x50)]

LCD Projector, PC/Laptop, Sound System

1. Penjelasan tentang Process Documentation tentang proses pembuatan

dokumentasi aplikasi (Buku Utama 3;ch.30 p.4-5)

3.

Mahasiswa dapat menjelaskan kategori-kategori dalam pembuatan dokumen aplikasi [C2,A2]

1. Ketepatan menjelaskan kategori-kategori yang terdapat dalam proses pembuatan dokumentasi aplikasi

2. Ketepatan menjelaskan ketergantungan proses pembuatan dokumentasi aplikasi dengan proses yang lain

email dosen

2.5%

1.Kuliah

perkuliahan [BT+BM : 1(2x50)]

1. Penjelasan tentang Process Documentation tentang kategori-kategori dalam pembuatan dokumen aplikasi

(Buku Utama 3;ch.30 p.4-5)

PRODUCT DOCUMENTATION

4.

Mahasiswa dapat menjelaskan tipe-tipe dokumentasi dan cara pemilihan tipe dokumentasi yang tepat sesuai kebutuhan aplikasi. [C2,A2]

1. Ketepatan menjelaskan tentang Buku panduan pengenalan

2. Ketepatan menjelaskan tentang Buku panduan pelatihan

3. Ketepatan menjelaskan tentang Buku panduan pengguna

4. Ketepatan menjelaskan tentang Buku reference

5. Ketepatan menjelaskan tentang Struktur berbasis tugas

Memilih 3 buku diperpustakaan dan menjelaskan tipe dari masing-masing buku tersebut.

Dikumpulkan M5 dikelas

2.5%

1.Kuliah

[TM : 1(2x50)] 2.Membuat

ringkasan 3 buku [BT+BM : 1(2x50)]

1. Penjelasan tentang Product Documentation tentang tipe-tipe dokumentasi

(Buku Utama 1 ch.2-4, Buku Utama 3 ch.30 p. 5-8,

(4)

5.

Mahasiswa dapat menjelaskan kebutuhan dokumentasi aplikasi pada setiap user yang berbeda [C2,A2]

1. Ketepatan menjelaskan pentingnya tahap investigasi terhadap user

2. Ketepatan menjelaskan macam-macam user

1.Kuliah

[TM : 1(2x50)]

[BT+BM : 1(2x50)]

1. Penjelasan tentang Product Documentation tentang macam-macam user

(Buku Utama 1 ch.5, Buku Utama 2 ch.1 p.1-13; ch.3 p20-25, Buku Utama 4 ch.2 p.6-19)

6.

Mahasiswa dapat menjelaskan kebutuhan dokumentasi aplikasi pada system dalam setiap tahapan pengembangan [C2,A2]

1. Ketepatan menjelaskan tahapan proses pembuatan aplikasi

2. Ketepatan menjelaskan dokumentasi apa yang dibutuhkan pada setiap tahapan proses tersebut

1.Kuliah

[TM : 1(2x50)]

[BT+BM : 1(2x50)]

1. Penjelasan tentang Product Documentation tentang kebutuhan dokumentasi aplikasi pada system

(Buku Utama 1ch.6,

Buku Utama 3 ch.30 p.5-8,

Buku Utama 4 ch.4 p.27-40)

DOCUMENT QUALITY

7.

Mahasiswa dapat menerapkan model penulisan yang benar pada dokumentasi aplikasi [C3,A3 ,P3]

1. Ketepatan menggunakan tata tulis dengan benar

2. Ketepatan menunjukkan obyektifitas tulisan dengan jelas

3. Ketepatan menentukan panjang kalimat dengan tepat

4. Ketepatan menerapkan model penulisan dengan teknik deskripsi

5. Ketepatan menerapkan Jargon dan kata teknis dengan tepat

6. Ketepatan menerapkan pPenggunaan angka, highligting, huruf besar dengan tepat

7. Ketepatan menerapkan penggunan

Quiz 2.5%

1.Kuliah

1. Penjelasan tentang Document Quality tentang style

(Buku Utama 1 ch. 12,

Buku Utama 2 ch. 9 p.89-109,

Buku Utama 3 ch. 30 p.11-12,

(5)

Minggu

Pembelajaran,

Estimasi Waktu,

[Pustaka]

bahasa sehari–hari dan humor dengan tepat

UJIAN TENGAH SEMESTER (25%)

8.

Mahasiswa dapat menerapkan elemen-elemen grafik pada dokumentasi aplikasi [C3,A3,P3]

1. Ketepatan mengenal elemen-elemen grafik

2. Ketepatan menerapkan standarisasi penggunaan tabel, diagram, grafik, flowchart, diagram kunci alfa, diagram garis, gambar

3. Ketepatan membuat desain tulisan dengan menentukan ukuran halaman, keseimbangan dan proporsi, kolom / grid, typefaces, header dan footer, symbol dan chart

4. Ketepatan menerapkan penggunaan ilustrasi dalam pembuatan buku panduan

Melakukan review tentang software documentation

2.5%

1.Kuliah

1. Penjelasan tentang Document Quality tentang elemen-elemen grafik

(Buku Utama 1 ch.7 & 13,

Buku Utama 3 ch.30 p.8-11,

Buku Utama 4 ch.6 p.62-70)

9.

Mahasiswa dapat menerapkan standard dokumen pada pada dokumentasi aplikasi [C3,A3,P3]

1. Memahami standarisasi proses penulisan dokumen aplikasi

2. Memahami standarisasi hasil penulisan dokumen aplikasi

3. Memahami standarisasi pertukaran dokumen aplikasi

1.Kuliah

[TM : 1(2x50)]

[BT+BM : 1(2x50)]

1. Penjelasan tentang Document Quality tentang standard dokumen pada pada dokumentasi aplikasi (Buku Utama 3 ch.30 p.13-15,

Buku Pendukung 3 ch.1-2)

10.

Mahasiswa dapat menerapkan standard dokumen pada pada dokumentasi aplikasi [C3,A3,P3]

1. Memahami standarisasi penulisan dokumentasi aplikasi berdasarkan standar IEEE

2. Ketepatan menerapkan standarisasi dokumen IEEE

Membuat draft standar dokumentasi aplikasi. Dikumpulkan M11

2.5%

1.Kuliah

[TM : 1(2x50)] 2.Membuat draft

standar dokumentasi aplikasi

[BT+BM : 1(2x50)]

LCD Projector,

1. Penjelasan tentang Document Quality tentang standard dokumen pada pada dokumentasi aplikasi (Buku Utama 2, ch.8 p.83-88,

(6)

PC/Laptop, Sound System

p15-16,

Buku Pendukung 3 ch. 3-5)

DOCUMENT PRODUCTION

11.

Mahasiswa dapat menerapkan Tahapan penulisan pada dokumentasi aplikasi [C3,A3,P3]

1. Ketepatan menjelaskan tahapan-tahapan dalam proses pembuatan dokumentasi 2. Ketepatan menerapkan

tahapan-tahapan tersebut (Penulisan draft awal, Penulisan Ulang dan Melakukan Edit)

Melakukan Editing pada draft standar dokumentasi aplikasi. Dikumpulkan M12

2.5%

1.Kuliah

[TM : 1(2x50)] 2.Melakukan Editing

[BT+BM : 1(2x50)]

1. Penjelasan tentang Document Production tentang Editing

(Buku Utama 1ch.9,

Buku Utama 2 , ch.8 p.83-88 & ch.10 p.111-123,

Buku Utama 3ch.30 p.16-19,

Buku Utama 4)

12.

Mahasiswa dapat menerapkan konsep dokumentasi online dalam pembuatan dokumentasi aplikasi [C3,A3 ,P3]

1. Ketepatan menjelaskan tentang dokumentasi online

2. Ketepatan menjelaskan keunggulan penggunaan dokumentasi online 3. Ketepatan penerapan batasan

dokumentasi online

4. Ketepatan membuat dokumentasi online dengan menggunakan aplikasi pembuat dokumen online (HelpnDoc dan

HTMLHelp)

Membuat

dokumentasi aplikasi online Dikumpulkan UAS (Presentasi)

10%

1.Kuliah

dokumentasi aplikasi online [BT+BM : 1(2x50)]

1. Penjelasan tentang Document Production tentang dokumentasi online (Buku Utama 3 ch.30 p19-21, Buku Pendukung 2 ch.12)

13.

Mahasiswa mampu membuat dokumen aplikasi sesuai dengan standar IEEE untuk Software Documentation [C4,A4 ,P4]

Ketepatan membuat dokumentasi aplikasi sesuai dengan tahapan proses pembuatan aplikasi dan dengan standar IEEE untuk Software Documentation

Membuat

dokumentasi aplikasi. Dikumpulkan UAS (Presentasi)

10%

1.Diskusi dan Konsultasi [TM : 1(2x50)] 2.Membuat

dokumentasi aplikasi.

(7)

Minggu

Pembelajaran,

Estimasi Waktu,

[Pustaka]

14.

Mahasiswa mampu membuat dokumen aplikasi sesuai dengan standar IEEE untuk Software Documentation [C4,A4 ,P4]

Ketepatan membuat dokumentasi aplikasi sesuai dengan tahapan proses pembuatan aplikasi dan dengan standar IEEE untuk Software Documentation

Membuat

dokumentasi aplikasi. Dikumpulkan UAS (Presentasi)

10%

1.Diskusi dan Konsultasi [TM : 1(2x50)] 2.Membuat

dokumentasi aplikasi.

[BT+BM : 1(2x50)]

UJIAN AKHIR SEMESTER (Presentasi : 25%)

Penilaian UTS (25%) Penilaian UAS (Presentasi : 25%)

Pertanyaan tentang Konsep Dokumentasi Aplikasi : 5% Presentasi Kelompok : 10% Pertanyaan tentang Process Documentation : 10% Pertanyaan Individu : 10% Pertanyaan tentang Product Documentation : 10% Pertanyaan kelompok : 5%

Catatan :

1 sks = (50’ TM + 50’ BT + 50’ BM)/Minggu BM = Belajar Mandiri BT = Belajar Terstruktur.

TM = Tatap Muka (Kuliah) PS= Praktikum Simulasi (100’/minggu) PL = Praktikum Laboratorium (100’/minggu)

Disahkan Oleh: Diperiksa Oleh: Dibuat Oleh:

Erwin Sutomo, S.Kom., M.Eng Kaprodi

Drs. Antok Supriyanto, M.MT