PBD 2

download disini

T. Dokumentasi Aplikasi Part 6

Pada Pertemuan 6 ini dipelajari tentang Graphic Elements (Gambar)

Terdapat kalimat yang menyatakan bahwa “1(satu) gambar itu mempunyai banyak arti”

Apabila gambar digunakan dalam buku maka akan meningkatkan keefektifitasan dari buku yang dibuat karena gambar tersebut memiliki banyak manfaat antara lain:

·         Membantu pembaca untuk memahami

·         Memastikan bahwa data yang tampil bermakna

·         Menentukan mekanisme fisik yang digunakan untuk mendapatkan file yang sesuai

Tipe dari Ilustrasi

Tabel: Menyediakan informasi secara cepat, jadi informasi yang terdapat pada table harus mudah ditemukan, mudah dipahami, mudah digunakan. Tabel harus punya judul(pendek tetapi tepat), ada penomoran, tidak bisa dipisahkan dengan isinya, memudahkan orang untuk membaca, apabila ada kolom yang bersesuaian akan lebih bagus lagi.

Railroad Diagrams: Menunjukkan bagaimana pengguna mencapai titik tertentu dalam software.

Alpha Key Diagrams: Menunjukkan dan memberikan label pada beberapa bagian dari gambar.

Terdapat pula Graph antara lain:

Bar Graphs(Grafik Batang-balok vetikal atau horisontal)

Line Graphs(Grafik Garis)

Pie Graphs( Grafik membentuk lingkaran)

Line Diagrams(Menunjukan hubungan antar objek—seperti hirarki)

T. Dokumentasi Aplikasi Part 5

Pada pertemuan 5 ini membahas tentang Style pada teknik penulisan aplikasi.

Controlled English

·         Gunakan tata bahasa yang benar

·         Bahasanya yang jelas

·         Kata-katanya harus sama (konsisten)

·         Apakah kalimat menyatakan pernyataan, kondisi kalimat, pertanyaan atau instruksi harus diperhatikan

Sentence Length

·         13(tiga belas) sampai 21(dua puluh satu) kata dalam satu kalimat

·         Gunakan kata-kata yang memang perlu dipakai

·         Kalimat mudah untuk dipahami dalam perolehan informasi

Clarity

·         Tidak membuat orang bingung(jelas, akurat, konsisten)

Pompous Style

·         Cara yang paling sederhana, tidak usah terlalu rumit

Jargon and Technical Terms

·         Ada pengekspresian ide pada kumpulan kata yang dibuat

·         Ada index

·         Ada glossary

Variety  and Inconsistency

·         Orang menjadi bingung karena ketidakkonsistenan sehingga perlu diperhatikan

Penggunaan Number (harus konsisten)

·         Number di dalam kalimat, ex: 2(dua)………………..

·         Penggunaan decimal harus ditentukkan

·         Apabila bagian harus romawi

·         Format tanggal harus diperhatikan

·         Format Waktu (Times) harus diperhatikan

·         Format nomor telepon juga harus ditentukan

Highlighting

·         Font bisa tebal (B)

·         Font bisa miring (I)

·         Font bisa garis bawah (U)

Capitalisation

·         Huruf Besar

·         Huruf Kecil

·         Huruf Awal Kapital

Colloquialism and Slang

·         Tetap pergunakan bahasa yang akrab tetapi tidak slang.

Humour

·         Menghibur (boleh memakai gambar lucu asalkan bukan gambar yang punya kesan negatif)

Using “He” or “She”

·         Menggunakan kata ganti orang, ex: Anda

Pemilihan kata: Bisa, Dapat, Mungkin itu ada pilihannya

Penggunaan Kata Singkatan ex: The Central Processing Unit (CPU)

Penggunaan tanda baca harus diperhatikan

Kekuasaan Dan Wewenang

·           Pengertian Kekuasaan

Menurut Max Weber, di dalam bukunya Wirtschaft und Gesellschaft (Tubingen, Mohr, 1922) Kekuasaan adalah kemampuan untuk, dalam suatu hubungan sosial, melaksanakan kemauan sendiri sekalipun mengalami perlawanan, dan apa pun dasar kemampuan ini. Dalam hal ini Max Weber mengartikan kekuasaan itu adalah sebuah kemampuan untuk membuat orang lain mau menerima dan melakukan apa yang menjadi kemauan kita walau mungkin hal tersebut tidak disetujui, bahkan ditentang. Selain itu menurut Harold D. Laswell dan Abraham Kalan bahwa kekuasaan adalah kemampuan untuk mempengaruhi orang lain sedemikian rupa, sehingga mereka mau menurti kehendak dari orang yang menjadi penguasa.

Jadi Kekuasaan adalah kemampuan untuk menggunakan pengaruh pada orang lain, artinya kemampuan untuk mengubah sikap atau tingkah laku individu atau kelompok. Kekuasaan juga berarti kemampuan untuk mempengaruhi individu, kelompok, keputusan, atau kejadian.

·           Pengertian Otoritas (Wewenang)

Menurut T. Hani Handoko, Wewenang adalah hak untuk melakukan sesuatu atau memerintah orang lain untuk melakukan atau tidak melakukan sesuatu, agar tercapai tujuan tertentu. Sedangkan menurut Hasibuan, hal. 66-67 Wewenang adalah kekuasaan yang sah yang dimiliki oleh seseorang untuk memerintah orang lain berbuat atau tidak berbuat.

Jadi Otoritas adalah wewenang, hak atau kuasa untuk mewajibkan kepatuhan (kekuasaan yang formal).
Dari segi iman Kristen, Allah mempunyai hak dan kuasa tertinggi untuk menuntut kepatuhan, karena Dialah sang Pencipta dan Tuhan segala bangsa.
Otoritas itu penting karena otoritas akan mengendalikan hidup seseorang:
 1) Mempengaruhi perilaku kita (baik atau buruk);
 2) Mempengaruhi keputusan-keputusan kita (benar atau salah);
 3) Mempengaruhi pilihan-pilihan kita (ya atau tidak).

·           Dalam hal ini dapat ditarik kesimpulan bahwa otoritas adalah sub bagian dari kekuasaan.

T. Dokumentasi Aplikasi Part 4

Untuk membuat daftar yang dibuat perlu diperhatikan info apa saja yang dibutuhkan. Analisis membutuhkan data, data diperoleh dengan cara melakukan survey. Hal-hal yang perlu ditanyakan pada pembaca (bias cari data pada badan survey/statistik) sebagai berikut:

·   Pengalaman sebelumnya dari pembaca dalam penggunaan sebuah produk (evaluasi)

·   Apa subject pengetahuan utama pembaca.

·   Daftar apa saja yang ada pada perusahaan.

·   Indikator apa saja yang dibutuhkan oleh pembaca.

·   Indikator apa saja yang telah ada tetapi tidak diperlukan (perlu dievaluasi kembali apakah user masih perlu atau tidak).

·   Profil (apakah kita tahu tentang info sesuatu itu kita peroleh dari siapa).

Rules

·         editor harus membaca detail oleh dokumentator(dikoreksi).

·         direview kembali berulang-ulang.

Chapter (Heading 1)

·         Di buku harus ada chapter, minimal satu chapter (untuk menjelaskan garis besar).

·         ada index.

·         Satu halaman kurang tetapi 50 halaman terlalu panjang sehingga antara 1 s/d 50 halaman.

·         Ada relasi untuk bahan.

·         Memungkinkan sebuah buku ada chapter tetapi harus ada judulnya.

Sections and Subsections (Heading 2 dan 3)

·         Breakdown dari yang pertama (chapter).

·         Seharusnya minimal ada satu kegiatan.

Paragraph

·         Kalimat utama yang mendukung dari ide.

·         Jangan menggunakan satu kalimat dalam satu paragraph, paling tidak ada dua atau tiga minimal.

·         Beri jarak.

·         Jangan memisahkan kalimat paragraph dengan page breaks.

Appendices

·         Daftar kata.

·         Menjelaskan informasi berdasarkan huruf depan.

Headings

·         Pembaca ingin melihat ide ditampilkan penulis.

·         Harus sesuai dengan isi.

·         Lebih relevan terhadap isi.

·         Untuk pemilihan kata (penulisan) harus konsisten.

Cautions and Warnings : petunjuk dan pemakaian (peringatan)

Note: catatan khusus

Cross References: dapat melihat detailnya dari tempat lain

Text Formats: tanda penghubung, list angka, dialog(beberapa pertanyaan), keyword list (daftar kata kunci)

Perbedaan bullets & number yaitu bullets bias diacak dan masih belum tahu jumlahnya tetap apabila number harus urut dan tahu jumlahnya.

T. Dokumentasi Aplikasi Part 3

Pada pertemuan ketiga ini membahas tentang seperti apa buku yang baik, syarat buku yang baik itu seperti apa, apa yang harus dilakukan untuk menjamin dokumentasi, langkah penulisan, serta penjelasan tentang model manual yang dibuat.

Buku yang baik itu relative jadi tergantung dari pembacanya (mengerti apa tidak terhadap isi dari buku tersebut). Buku yang baik harus sesuai dengan persyaratan,  syarat-syaratnya adalah apabila publikasi itu punya nilai tambah maka buku itu bagus, informasi tidak sulit untuk diperoleh, pelanggan tidak perlu Tanya bias bekerja lebih cepat, pelatihannya lebih rendah biayanya, akan memberikan batasan yang rendah kepada pembaca sehingga pembaca tertarik membaca, dibutuhkan oleh macam-macam komunitas, tidak perlu turun ke lapangan terlalu sering untuk membenahi permasalahan, meningkatkan penjualan.

Tiga yang biasa dilakukan untuk menjamin dokumentasi yaitu standart ISO (format penulisan huruf, bentuk tulisan, penggunaan istilah, bahasa yang digunakan & singkatan-singkatan, pengaturan publikasinya bagaimana, daftar pustaka, penjelasan bagian), orangnya mengerti apa yang ditulis, menggunakan alat yang baik. Terdapat pula enam langkah dalam proses penulisan yaitu menganalisa pendengar, membuat definisi pokok, membuat definisi detail, memilih style dan format yang digunakan, menulis manual,harus ada yang membaca dahulu sudah legal atau belum. Empat model manual yang biasa dibuat bersama software berikut beserta penjelasannya:

·   Pengenalan Manual: tujuannya akan memberikan gambaran umum terhadap produk yang mungkin akan menarik. Style harus jelas, pembaca harus ingin untuk melanjutkan membaca.

·   Trainning Manual: tujuan supaya orang itu belajar, memperkenalkan user sistemnya/produknya, harus sebagai pembimbing. Isinya ada setiap bab, ada tujuan dan pembatasan, tidak membicarakan produknya seperti apa. Style mudah dibaca, harus sering mengulang perintah-perintah, ada jaminan kalau ada masalah cara pembenaannya, ada instruksi step by step, antisipasi kesalahan, harus ada pendamping, audience harus mengerti jangan meninggalkan pertanyaan kepada pembaca.

·   User Manual: tujuannya usernya sudah paham terhadap isinya, memperkenalkan sistem itu bisa apa saja, bagaimana produk itu digunakan, menunjukan caranya. Isi harus fokus(tidak kemana-mana), menyeluruh(orang membaca lebih enak). Style tetap ada langkah-langkah tetapi tidak semudah trainning.

·   References Manual:tujuannya kesalahan apapun bisa dicari, pengetahuannya untuk semua orang. Style menjelaskan langsung, orang sudah paham alurnya, tersedia index.

Semua model buku pastinya harus bisa membantu pembacanya untuk menyelesaikan masalah.

T. Dokumentasi Aplikasi Part 2

          Ketika kita sudah mengevaluasi proyek serta memutuskan untuk melanjutkan proyek tersebut maka langkah yang harus dilakukan adalah mendokumentasikan perencanaan proyek dimana ada hal-hal yang perlu untuk diperhatikan antara lain mulai dari pengantar, proposal, keterbatasan sistem, estimasi, prosedur, dan referensi. Dalam hal ini perlu diketahui bahwa sebuah proposal adalah dokumen yang merinci biaya dan jadwal proyek serta garis besar langkah – langkah yang akan digunakan oleh suatu perusahaan untuk memproduksi produk. Tentang bagaimana anggota – anggota tim muncul dengan biaya, jadwal, dan langkah – langkah yang diinginkan. Pada proposal terdapat sebuah pendahuluan rencana proyek. Sebuah rencana untuk proyek software yang menjabarkan akrifitas yang diinginkan, berapa lama setiap aktifitas dilakukan, kapan aktifitas ini harus mengambil tempat dan berapa banyak sumber daya yang dihabiskan pada setiap aktifitas untuk memproduksi hasil yang diinginkan(solusi yang tepat). Untuk keterbatasan sistem yang hrs diperhatikan adalah keutamaan pelanggan, siapa profil penggunannya, kira-kira aplikasi yang dibuat bias bertahan berapa lama, kira-kira kendalanya seperti apa ketika memakai aplikasi tersebut, seperti apa kinerjanya, apabila eror gimana solusinya sehingga data tetap terjaga, solusi untuk mentraining user, dan bisa memakai tidak lingkungannya. Estimasi meliputi waktu dan pengerjaannya kira-kira berapa lama apabila memakai aplikasi yang akan dibuat, bagaimana pengelolaan jadwal, pembagian tugas sesuai dengan standar organisasi, ada budget, keuntungan apabila memakai aplikasi yang akan dikerjakan, perlu diperhatikan analisis resiko, aplikasi tersebut harus menghasilkan dokumen apa saja, perangkat lunak serta fasilitas yang dibutuhkan juga perlu diperhatikan. Bagaimana pengerjaannya (Prosedure) yaitu apabila mengikuti acuan kerja dari perusahaan ya harus notasinya sama, memakai metodologi apa, quality control (QC) siapa, harus diapakan produknya, data yang kita peroleh bagaimana (penerimaan, pengiriman, pembayaran). References Dokumentasi yang dibuat harus sesuai dalam pengembangannya, kamus istilah termasuk notasi-notasi yang ada pada aplikasi, bagaimana kontrak yang diusulkan. Terdapat juga Dokumentasi spesifikasi Desain (SRS—stadarnya sudah ditentukan) disini terdapat pendahuluan, spesifikasi singkat, desain arsitektur, desain secara detail, dan referensi. Dokumentasi pengembangan sistem adanya dokumentasi pihak user membutuhkan apa saja, spesifikasi, desain utama, implementasi & pemilihan teknologi dan pengujian (testing). Dalam hal ini diharapkan nantinya sampai pada user manualnya karena aplikasi tidak akan lengkap tanpa ini. Terdapat tutorial tentang apa yang harus dilakukan oleh user sehingga kita tidak direpotkan oleh user. Dokumentasi Maintenance menjelaskan tata cara perawatan dan pengelolaan sistem yang baik. Dokumentasi Source Code adanya kejelasan program tersebut dimana codingnya harus jelas sehingga apabila ada org yang meneruskan program tersebut bisa lebih mudah menangkap bagaimana program tersebut dengan coding2 yang sedemikian rupa. Dokumentasi Testing bagaimana metode cara pengujiannya, apakah benar entriannya sesuai, jadi setiap ada pengujian harus ada dokumentasinya.

Investigasi dimana supaya kita paham apa yang diinginkan oleh user maka kita harus menganalisa. The Investigation Stage harus ada apa saja dalam dokumentasi, harus mengetahui apa yang harus anda tulis dan gali dengan sedalam mungkin. Considering Your Audience siapa yang akan membaca buku manual harus diperhatikan, Determing The Optimum Length Of The Books seberapa tebal buku sehingga ketika orang ingin mendapatkan jawaban dari masalahnya orang tidak malas mencari dan yang diinginkan dapat segera ditemukan. Looking At The Sistem benar-benar harus mengupas sistemnya (pahami betul alur kerja system, perbagian dari system dituliskan dengan lengkap. Starting The Investigation harus mengetahui proses bisnis dari awal sampai akhir, kesulitan dan kemudahan system, lihat usernya bukan pembuat sistem. Determining The Books Titles judul buku dengan jelas menjelaskan apa isi dari buku, dengan jelas tertulis kebutuhan user. Avoiding The Pitfalls jangan membuat orang bingung ketika membaca dokumentasi tersebut, gunakan kata-kata yang bisa dipahami.