Information Systems Management (IMS552)

Chapter 6
Documentation
In ISD
Ahmad Nadzri Mohamad
Senior Lecturer
School of Information Science
College of Computing, Informatics
& Mathematics
nadzri590@uitm.edu.my
Documenta
tion ISD
Definition
Types of
Documentation
Document
Development
 Definition
any communicable material
that is used to describe,
explain or instruct regarding
some attributes of an object,
system or procedure for
activities/process that related
to Information Systems
Principles of Information Systems, 3
Eighth Edition
Types of Documentation
Software Document

Definition 1
All information that describes the
development, operation, use, and
maintenance of computer software.
This information is in a form that can
be reproduced, distributed, updated,
and referred to when it is needed 4
Types of Documentation
Software Document

Definition 2
Software documentation is a form of
writing for both print and online media
that supports the efficient and
effective use of software in its
intended environment

5
 Software Document
Purpose and types Software Document

The documentation that accompanies

software products tends to fall into two
broad categories. According to Barker in
Documentation for Software and
Information Systems Development, there
are two main types of software
documentation:
a.Development documents
b.User documents. 6
 Software Document
a. Development Documents

Purposes:
• To track product development by creating
information about the development process.
• to create product information for user
documents

7
Software Document
a. Development Document

8
 Software Document
b. User Documents

Purposes:
• to teach and guide users in the use of the
product.
• to help or support users in carrying out
their work-
related tasks more efficiently and
effectively.

9
Software Document
b. User Documents

10
Documentation Development
Cycles
Standard Operating Procedure (SOP)

A process document that

describes in detail the way that
an operator should perform a
given operation (Akyar, 2012)

11
Documentation Development
Cycles
Standard of Procedure
(SOP)
To ensure:
all workers are performing tasks
ways, which is a needed for
condition to get expected output
from the process

12
MAMPU : ACT & CIRCULARS
CYBER SECURITY
MALAYSIA
MALAYSIAN STANDARDS
ONLINE
MALAYSIAN STANDARDS
ONLINE
 INFORMATION
TECHNOLOGY
INFRASTRUCTURE
LIBRARY (ITIL)

PRINCIPLES OF INFORMATION SYSTEMS, EIGHTH EDITION

Document Development
Cycles
Desk File/ Fail Meja

A desk file is an official document or

manual for a position at an individual
level. Contains detailed guidance and
information on the daily tasks carried
out by an individual for the position
held. Desk File is an important
management tool that can contribute
to increase productivity
18
Document Development
Cycles
Desk File/ Fail Meja
Purpose;
•to improvise the efficiency and effectiveness of
each individual
•to provide detailed guidance on all the tasks
carried out by an individual every day.
•provide list duties and responsibilities of an
individual
•Provide series of procedures and checklists found
that are step-by-step guidelines that can guide each
individual perform their duties efficiently
19
•reference document for every officer to carry out
Document Development
Cycles
Sasaran Kerja Tahunan (SKT)/ Key
Performance Indicator (KPI)
• Generally, KPI is a quantifiable
measure of performance over time
for a specific objective
• Formula to measure progress, quality
and level of service towards achieving
the organization’s objectives.

Principles of Information Systems, 20

Eighth Edition
Document Development
Cycles
Sasaran Kerja Tahunan (SKT)/ Key
Performance Indicator (KPI)
Contain of combination of inputs, outputs
and outcome information on..
• Workload indicators : output
oriented
• Efficiency indicators : compare
resource inputs against resulting
outputs
• Effectiveness indicators : measure
the extent to
Principles of which
Information
Eighth Edition
services
Systems, achieve 21