FIKRI RAZZAQ ARASYID

1301144425

Dokumentasi Perangkat Lunak

Software Development Life Cycle (SDLC)
Ada beberapa fase dalam proses pembuatan suatu perangkat lunak atau Software Development
Life Cycle (SDLC). Secara garis besar, SDLC terdiri atas:
1. Requirement Analysis
2. Design
3. Development
4. Testing
5. Deployment & Maintenance
Kelima fase tersebut merupakan tahap-tahap penting yang harus dilalui dalam proses pembuatan
suatu perangkat lunak.
Deployment & Maintenance
Fase ini merupakan suatu tahap ketika perangkat lunak telah melewati tahap pengujian dan
telah rampung sepenuhnya sehingga siap untuk dirilis dan dipasarkan. Namun, perangkat lunak
yang telah rampung tidak mungkin untak dilepas begitu saja kepada, melainkan perlu adanya
suatu pelatihan dan bimbingan kepada para pengguna/klien yang diproyeksikan untuk
menggunakan perangkat lunak tersebut dalam penggunaannya. Ini merupakan tahap yang paling
penting dalam fase deployment.
Selain itu, perlu adanya maintenance atau pemeliharaan terhadap perangkat lunak yang telah
dirampungkan tersebut untuk mengatasi masalah yang timbul atau adanya requirements atau
kebutuhan-kebutuhan baru yang dapat menghabiskan cukup banyak waktu. Di fase ini tidak
jarang terjadi requirement baru dari klien yang mengharuskan penambahan update yang tidak
sesuai desain asli untuk memperbaiki masalah yang tak terduga sehingga biaya development pun
akan bertambah.
Dokumentasi Perangkat Lunak
Pembuatan dokumentasi berada pada fase Design dan Deployment & Maintenance.
Dokumentasi dibuat tertulis yang didalamnya meliputi keseluruhan perangkat lunak yang telah
dibuat, baik itu sistem kerja dari perangkat lunak tersebut atau cara penggunaannya yang
dibedakan berdasarkan peran yang dilakukan pengguna dalam pengoperasiannya. Bagian ini
merupakan salah satu bagian penting dalam Software Development Life Cycle. Ada beberapa tipe
dokumentasi, diantaranya :
1. Requirements (Pada Fase Design)
2. Architecture/Design (Pada Fase Design)
3. Tehcnical
4. End User
5. Marketing

FIKRI RAZZAQ ARASYID

1301144425

1. Requirement Documentation
Dokumentasi ini didalamnya terdapat penjelasan mengenai apa yang akan dilakukan oleh
perangkat lunak yang dibuat. Dokumentasi ini digunakan selama masa pengerjaan perangkat
lunak untuk men-sinergikan apa yang akan dilakukan oleh perangkat lunak tersebut.
Kebutuhan akan requirement documentation bergantung pada kompleksitas produk, pengaruh
dari produk dan harapan yang didapatkan dari perangkat lunak tersebut.

2. Architecture / Design Documentation

Architecture Documentation dapat dikatakan sebagai turunan ketiga dari kode program.
Dokumen ini tidak menjelaskan cara kerja dari perangkat lunaknya, melainkan hanya
penjabaran persyaratan umum dari perangkat lunak yang akan dibuat. Dokumen ini dapat
dikatakan sebagai induk dari dokumen lainnya yang akan dibuat. Dan bagian terpenting dari
dokumen ini adalah Database Design Document yang meliputi bagian Conceptual, Logical
dan Physical Design dari suatu database.

3. Technical Documentation
Terdapat penjelasan mengenai fungsi-fungsi pada perangkat lunak yang dibuat di dokumen
ini. Dan dokumen ini berguna sebagai referensi bagi pembuat perangkat lunak, arsitek teknis
dan desainer terkait dengan fungsi dari aplikasi. Bagi kebanyakan perangkat lunak,
dokumentasi ini dapat berupa informasi mengenai :
a. File-file penting pada perangkat lunak
b. Detail dari fungsi perangkat lunak
c. Detail dari tujuan penggunaan perangkat lunak
d. Penjelasan teknis dari setiap bagian perangkat lunak
e. 3rd Party Object,penjelasan objek pendukung yang dibutuhkan dan digunakan dalam
perangkat lunak
f.

Rincian dari Application Programming Interface (API)

g. Entitas yang terhubung pada database

FIKRI RAZZAQ ARASYID

1301144425
4. End User Documentation
Dokumentasi ini biasa disebut dengan user manual yang akan digunakan oleh pengguna,
sistem administrator dan staf pendukung. Dalama dokumen ini terdapat penjelasan dari fiturfitur perangkat lunak dan akan membuat pengguna tau fungsi dan kegunaan dari setiap fitur.
Adapun penjelasan troubleshooting yang bertujuan untuk cara penanganan masalah yang
terjadi pada perangkat lunak tersebut. Ada beberapa cara dalam pembuatan dokumentasi
berdasarkan pemanfaatannya, yaitu :
a. Tutorial
Ini akan sangat berguna bagi pengguna baru dari perangkat lunak yang dibuat. Terdapat
panduan tahap demi tahap dalam penggunaannya.
b. Thematic
Difokuskan pada suatu bagian dari perangkat lunak tersebut dan biasanya ini digunakan
oleh pengguna menengah.
c. List or Reference
Bagian-bagiannya tersusun berdasarkan indeks huruf A-Z ataupun digolongkan
berdasarkan kategori-kategori. Biasanya ini digunakan untuk pengguna berpengalaman
yang mengetahui jenis informasi yang akan dicari.
Terdapat lima tahapan dalam pembuatan dokumentasi ini:
(1) User Analysis
(2) Planning
(3) Draft Review
(4) Usability Testing
(5) Editing

5. Marketing Documentation
Dokumentasi ini dibutuhkan jika perangkat lunak akan dikomersilkan dan dengan adanya
marketing dokumentasi ini maka akan terdapat bahan-bahan promosi untuk menarik perhatian
pasar. Ada tiga tujuan dari dokumentasi ini:
a. Menumbuhkan rasa ketertarikan pengguna mengenai produk dibuat dan akan timbul
keinginan untuk lebih mengetahuinya.
b. Menginformasikan pada pasar mengenai produk dibuat sehingga perkiraan dan harapan
mereka tentang produk akan sama dengan apa yang akan mereka terima.
c. Menjelaskan posisi dari produk yang dibuat tanpa menyudutkan produk alternatif dari
developer lainnya.

FIKRI RAZZAQ ARASYID

1301144425

DAFTAR PUSTAKA
Cairo University. (2013). M.C.A. (Sem -I) Paper - II - System Analysis and Design. Retrieved from
Course Hero: https://www.coursehero.com/file/p6d779t/In-the-case-of-a-software-library-thecode-documents-and-user-documents-could/
Choudhury, A. (2011, November 27). Software Development Life Cycle (SDLC) Phases. Retrieved
from SDLC Tutorials: http://www.sdlc.ws/software-development-life-cycle-sdlcphases/#Maintenance
ISTQB. (n.d.). What are the Software Development Life Cycle (SDLC) phases? Retrieved from
ISTQB EXAM CERTIFICATION: http://istqbexamcertification.com/what-are-the-softwaredevelopment-life-cycle-sdlc-phases/
SoftwareDocumentation.info. (2007). How to write good software documentation. Retrieved from
SoftwareDocumentation.info:
http://www.softwaredocumentation.info/DocumentingSoftware.aspx
Wikibooks. (2014, November 30). Introduction to Software Engineering/Process. Retrieved from
Wikibooks: http://en.wikibooks.org/wiki/Introduction_to_Software_Engineering/Process