Sabtu, 22 Oktober 2011

Teknik Dokumentasi Aplikasi

Pertemuan 6
Graphic Elements

1. Jenis ilustrasi
a.Tabel ==> menyediakan metode pencarian informasi secara cepat dan akan dirujuk oleh pembaca beberapa kali.
  • Harus mudah ditemukan pada setiap pencarian
  • Harus mudah dipahami dalam setiap isi dari tabel tersebut
  • Harus dapat digunakan dalam berbagai hal
  • memberikan judul - singkat dan tepat
  • memberikan nomor tabel
2. Diagram Raiload ==> berguna untuk menunjukkan bagaimana pengguna mencapai titik tertentu dalam software
  • Training Manual-- lebih baik jika diikuti dengan pemberian penomoran, yang menampilkan hasil tiap langkah-langkah sehingga user tahu
3. Alpha Key diagrams==> menunjukkan dan memberikan label pada beberapa bagian dari gambar

4. Graphs
  • Diagram Garis >> digunakan untuk menunjukkan hubungan antara objek

Teknik Dokumentasi Aplikasi

Pertemuan 5
STYLE

1. Panjang Kalimat
  • Informasi mudah dimengerti
  • Menggunakan kalimat yang singkat dan sederhana
  • Kalimat antara 13-21 per kalimat
  • Apabila terdapat kata-kata yang tidak diperlukan sebaiknya di hapus
2. penomoran dalam tampilan
  • Nomor dalam text
  • bab, bagian, halaman dan bagian nomor
  • angka terkait dengan unit
  • tanggal
  • waktu
  • nomor telepon 
3. highlighting
  • Penebalan dalam tulisan ( Bold )
  • Untuk mengubah tulisan menjadi miring ( Italic )
  • Untuk memberi garis bawah pada text ( Underlining )


Teknik Dokumentasi Aplikasi

Pertemuan 4
Tulisan Pertama

Peraturan : 
  • Editor harus membaca detil apa saja yang dibuat dokumenter
  • Editor sering membaca ulang lagi
  • Belajar dari kesalahan
*** 10 aturan dalam menulis ***
  1. Identifikasi target audien / pembaca konten anda
  2. Bicara menggunakan bahasa pembaca
  3. Hindari menggunakan istilah-istilah jargon intelek
  4. Hindari menggunakan kalimat terlalu panjang dan berbelit-belit
  5. Gunakan kalimat singkat dan sederhana
  6. To the point
  7. Katakan pada pembaca tentang keuntungan bagi mereka
  8. Berikan sentuhan kreatifitas pada artikel
  9. Review ulang copywriting anda
  10. Maksimalkan segala informasi

Minggu, 16 Oktober 2011

Resume Pemrograman web

Pertemuan III
Site Navigation
Tanggal 19 September 2011

       Site Navigasi mempermudah dalam membuka situs, navigasi ini sangat diperlukan, jika suatu situs susah dalam mencari apa yang diinginkan. dan apabila dalam situs itu tidak ada kemudahan dalam membuka situs maka para pengunjung situs itu akan kehilangan minat dan akan berpindah ke situs yang lain.
       Dengan site navigation bisa menciptakan navigasi yang mudah dan konsisten. Control utama yang digunakan suatu navigasi situs adalah Menu dan TreeView. Control Menu menawarkan link navigasi menu dropdown sederhana. biasanya control ini cocok untuk situs yang tidak mempunyai banyak halaman web dan merupakan bentuk yang sederhana, selanjutnya Control TreeView yang menawarkan struktur navigasi dalam bentuk tree yang bisa dibuka dan ditutup dengan menekan tanda + atau - disebelah kiri masing-masing link. Control ini cocok untuk navigasi situs yang banyak memiliki banyak halaman web.
           Menu dan TreeView dapat menggunakan data statik ataupun data dinamik. apabila menggunakan data statik, maka struktur navigasi dari situs navigasi sebagai dari control. dengan data dinamik data tentang struktur file diletakkan pada sebuah file bernama sitemap diluar control. keuntungan dengan menggunakan cara ini yaitu tidak perlu menggubah satu-satu dari setiap kontrol jika ada perubahan. cukup mengubah sitemap dan semua kontrol yang memakai file ini akan ikut berubah.

Selasa, 27 September 2011

Teknik Dokumentasi Aplikasi

Pertemuan 3
tipe untuk buku
1. Teknik publikasi mempunyai nilai antara lain :
  • Buku yang bagus pastinya sangat berkualitas tinggi. Bagi para pembaca itu termasuk hal yang sangat bermotivasi tinggi bagi para pembaca.
  • informasi yang diberikan juga akan mudah diterima oleh para pembaca
  • customer juga tidak sering-sering untuk bertanya tentang buku itu. apabila buku itu sudah berkualitas tinggi
  • training lebih mudah
  • para publikasi akan memberikan batasan kepada orang yang tidak menyukai membaca.
  • kualitas banyak yang membutuhkan buku misalnya buku pelajaran, novel dan lain-lain
  • dalam melakukan pekerjaan, para publikasi tidak banyak yang bekerja sampai turun ke lapangan.
2. Buka yang bagus harus mempunyai beberapa hal yaitu :
  • Standart ---> dalam hal pemilihan huruf, supaya pembaca tidak kesulitan dalam membaca
  •               ---> cara penulisan, penulisan harus baik dan dapat dimengerti oleh para pembaca
  •               ---> apabila terdapat suatu singkatan dalam sebuh buku sebaiknya singkatan itu diberi keterangan

Rabu, 21 September 2011

Teknik Dokumentasi Aplikasi

pertemuan 2
Investigasi
nama dosen : Bu tyas


Tahap Penyelidikan
     ada dua tahap investigasi dalam proses menulis. tujuan awal untuk mengembangkan ide-ide tentang persyaratan dokumentasi. tahap penyelidikan kedua adalah di mana Anda harus pergi ke subjek secara lebih mendalam dan muncul dengan rincian yang memadai untuk menulis buku. tergantung pada sistem dan situasi Anda, Anda sudah mungkin telah melakukan banyak penelitian ini pada tahap awal, akan tetapi anda tidak diragukan lagi, akan daerah di mana Anda merasa kurang nyaman tentang informasi yang diperoleh sebelumnya. Jadi bagaimana  Anda benar-benar tahu tentang topik atau penonton? untuk mulai bekerja dengan sedikit pengetahuan . kita akan mulai dengan melihat bahwa audiens daerah-Anda yang paling penting.
  
Tahap Mempertimbangkan Audien
     bahkan produk atau layanan yang tidak dikemas mungkin sesuatu yang kompromi kepada anggota keluarga yang banyak menggunakannya. suatu tempat di sepanjang garis selama proses desain, keputusan sewenang-wenang akan telah dibuat dan tujuan komersial akan mengambil yang diutamakan adalah kebutuhan individu. untuk menjaga keseimbangan, kita tidak harus mengabaikan fakta bahwa, hanya sesekali, pengguna permintaan bisa sangat rewel!


Tahap menentukan panjang optimal dari buku
     buku pendek lebih mungkin dibaca daripada yang panjangbenar juga untuk mengatakan bahwa kemarahan yang benar pada bagian dari penulis atau manajemen lebih dibenarkan atas sebuah buku yang belum dibaca dari 5.000 kata - katakanlah 30 halaman, dari 80.000 kata atau 480 halaman. yang lebih penting, buku pendek tidak akan hanya dibaca, akan dipahami-memberikan tentu saja bahwa itu ditulis dengan baik.


Tahap melihat sistem 
      penulis harus membutuhan dan menangani sistem dari dua sudut. itu adalah kebutuhan untuk memeriksa tidak hanya 'mur dan baut' dari struktur sistem, opsi, dan fitur, tetapi juga aplikasi praktis dari setiap elemen.


sistem komputer untuk mencerminkan kegiatan seperti ini dapat mencakup modul berikut:
  • pengendalian stok, termasuk ketentuan untuk back-order
  •  memeriksa kredit pelanggan
  •  pemrosesan order, termasuk antarmuka dengan kredit, saham pelanggan, dan kartu kredit modul
  •  pengiriman perencanaan, termasuk rincian perkiraan kedatangan di tempat pelanggan
  • persiapan pengepakan dan pengiriman dokumentasi

sumber : Low Roderick with Ford Harriet, Pallot John and Hall James.1994 Writing User Documentation, A Practical Guide for those who want to be read    

Rabu, 14 September 2011

Resume Pemrograman web

PERTEMUAN I
Definisi dan Sejarah
HTML,SCRIPTING dan CSS

Tanggal : 12-09-2011
Definisi HTML
    HTML adalah sebuah halaman web yang menampilkan berbagai informasi di dalam sebuah penjelajah web internet.

Sejarah HTML
    Pada tahun 1980, IBM memikirkan untuk pembuatan suatu dokumen yang akan mengenali sekali elemen dari dokumen dengan suatu tanda tertentu. IBM juga mengembangkan suatu jenis bahasa yang menggabungkan teks dengan perintah-perintah pemformatan dokumen. 
    Dan pada tahun 1986 ISO menyatakan bahwa IBM memiliki suatu konsep tentang dokumen yang baik, dan mengeluarkan suatu publikasi (ISO 8879). HTML juga berupa kode yang menginstruksikan penjelajahan web untuk menghasilkan tampilan sesuai yang diinginkan.

Definisi CSS
    CSS(Cascading Style Sheets) adalah mengatur tampilan suatu dokumen yang ditulis dalam bahasa markup. CSS berurusan dengan mendesain halaman web, antara lain theme/template dan lain-lain.

Sejarah CSS
    Pada tanggal 17 Agustus 1996, World Wide Consortium (W3C) menjadikan CSS sebagai pemrograman Standart dalam pembuatan dokumen web. Tujuan untuk mengurangi pembuatan tag-tag baru oleh netscape dan internet explorer.

Definisi SCRIPTING
    Script yang kode program tidak perlu pra_pengolahan(misalnya Kompilasi) sebelum dijalankan. Dalam konteks Web Browser, script biasanya mengacu pada kode program yang ditulis dalam JavaScript yang dieksekusi oleh browser ketika halaman di download atau sebagai respon terhadap suatu peristiwa yang dipicu oleh pengguna.
    Scripting dapat membuat halaman web lebih dinamis. sebagai contoh, tanpa reload. atau mengijinkan konten yang akan ditambahkan atau dikirim dari halam tersebut.
    Scripting dibagi menjadi dua yaitu :
  • Server Side Scripting --> Script yang ada disisi server
  • Client Side Scripting --> Script yang ada disisi client
Sejarah SCRIPTING
    Pada tahun 1996 Script diperkenalkan oleh Michael Power 3 DML menggunakan XML non standart serta hanya bisa dibuka oleh satu browser saja.
    Pada tahun 2000 --> DHTML diperkenalkan dengan akhirnya dikembangkan lagi menjadi JavaScript.


PERTEMUAN II
Definisi dan Penggunaan
Web Form(.aspx), Master Page, Table, Font, Hyperlink, Image 

Tanggal :16-09-2011
Master Page
   Cara baru yang diguanakan  pada ASP.Net yang biasanya digunakan agar situs yang dibuat menjadi konsisten terhadap desain dan tampilan. Dan dengan master page juga bisa didefinisikan format tampilan umum yang muncul pada setiap halaman website.
   Cara mendesain suatu tampilan pada master page, bisa menggunakan CSS atau juga dengan menggunakan Style Builder dengan cara klik kanan pada master page dan memilih style. Dan cara penggunaan master page adalah dengan memilih ketika membuat halaman web baru dengan melakukan cek pada cheekbox "select Master Page"

Web Forms
    Model pemrograman yang dapat digunakan oleh server untuk melakukan proses dan menghasilkan web page yang dinamis. contoh penggunaan --> isi suatu halaman dalam web

Table
    Menata suatu informasi agar sesuai dengan yang diinginkan, dan dengan table juga dapat membagi-bagi halaman web yang sesuai. Penggunaan--> klik menu layout-insert table setelah itu muncul jendela Insert table, dan setelah itu bisa memilih antara temlate yang sudah disediakan atau bisa dengan membuat table sendiri.

Font
    Untuk mengatur ukuran, warna, jenis font dan dapat menggunakan tag <FONT> dan </FONT> cara mengganti font keseluruhan halaman pada source <body>
<body Style ="Font-Family :Arial ; Font-size :smaller">

Gambar
   Untuk menyisipkan suatu gambar di dalam halaman web. cara penggunaan--> membuat folder baru setelah itu drag drop image yang akan digunakan dan taruh cursor pada header dan setelah itu klik kanan pada header yang dituju dan pilih background..maka gambar akan masuk pada header tersebut.

Hyperlink
    Halaman web yang terdapat untuk menghubungkan antara satu halaman web dengan halaman web yang lain. cara penggunaan--> dengan menggunakan tag<A> dan </A>. pemakaian tag ini diikuti dengan atribut HREF sebagai alamat dari halaman web yang dituju <a href="Target.html"> arsitektur asp.net </a>

sumber :
  • Handoyo kristanto .2002,Pemrograman aplikasi web dengan ASP.Net.Jakarta: PT. Elex Media Komputindo
  • Rickyanto,isak.2003.Membuat aplikasi web dengan ASP.Net.Jakarta: PT. Elex Media Komputindo