정보처리기사 18일차

2. 소프트웨어 개발

 2.3 제품소프트웨어 패키징

 2.3.3 제품 소프트웨어 매뉴얼 작성

---

1. 제품 소프트웨어 매뉴얼 작성

 

1.1 제품 소프트웨어 매뉴얼 개요

제품소프트웨어 매뉴얼은 설치 매뉴얼과 사용자 매뉴얼이 있다.

 

1.2 제품소프트웨어 설치 매뉴얼

 

1. 제품소프트웨어 설치 매뉴얼이란?

사용자가 제품 구매 후 최초 설치 시 참조하는 매뉴얼이다.

제품 소프트웨어 소개, 설치 파일, 설치 절차 등이 포함된다.

 

2. 제품소프트웨어 설치 매뉴얼의 기본 작성 항목

목차 및 개요 : 매뉴얼 전체 내용에 대한 요약

문서 이력 정보 : 매뉴얼 변경 이력 정보

설치 도구 구성 : exe/dll/ini/chm 등 설치 관련 파일 설명

설치 위치 지정 : 설치 폴더와 설치 프로그램 실행 파일 설명

설치를 위한 환경 체크 항목

 

3. 제품소프트웨어 설치 매뉴얼 구성요소

제품 소프트웨어의 설치 방법을 순서대로 상세하게 설명한다. 주로 화면을 계속 캡쳐하여 사용자가 이해하기 쉽도록 구성한다.

설치화면은 exe 등 install 파일을 실행하도록 화면을 첨부한다.

설치 실행 시 표시되는 내용 및 안내창에 대한 메시지를 설명한다.

 

4. 제품소프트웨어 설치 매뉴얼 작성 순서

기능 식별 : 제품 소프트웨어의 개요 및 기능들을 식별한다.

UI분류 : 화면 단위로 작성될 UI를 분류한다.

설치/백업 파일 확인 : 설치 파일 및 백업 파일명 확인 및 폴더위치를 확인한다.

Uninstall 절차 확인 : 제품 제거 시 uninstall파일을 설명한다.

이상 Case 확인 : 설치 진행 시 이상 메시지 등에 대한 발생 시 조치 방안을 기술한다.

최종 매뉴얼 적용 : 최종 설치 정상 완료 시 결과를 캡쳐 후 최종 매뉴얼에 적용한다.

 

1.3 제품소프트웨어 사용자 매뉴얼 작성

 

1. 제품소프트웨어 사용자 매뉴얼이란?

개발이 완료된 소프트웨어를 고객에게 전달하기 위한 형태로 패키징하고, 설치와 사용에 필요한 제반 절차 및 환경 등 전체 내용을 포함한다.

제품소프트웨어에 대한 패치 개발과 업그레이드를 위해 버전 관리를 수행한다.

 

2. 제품소프트웨어 사용자 매뉴얼 작성 순서

• 작성 지침 정의
• 사용자 매뉴얼 구성요소 정의
• 구성 요소별 내용 작성
• 사용자 매뉴얼 검토

3. 제품소프트웨어 사용자 매뉴얼 작성 항목 

주로 화면을 계속 캡처하여 사용자가 이해하기 쉽도록 구성한다.

주요 기능을 설명할 화면을 첨부한다.

제품 소프트웨어 동작 시 함께 동작하는 App이나 설치되어 충돌될 수 있는 응용프로그램에 대해 보여준다.

제품 소프트웨어 동작 시 사전에 실행해야할 App이 있으면 기술한다.

제품 소프트웨어가 Embedded관련된 제품을 경우 해당 Device에는 어떤 것이 있는지, 연동되는 Device에는 무엇이 있는지 설명한다.

 

2. 국제 표준 제품 품질 특성

 

2.1 국제 표준 제품 관련 품질

 

1. 국제 표준 제품 품질 특성의 분류 

제품 품질 표준과 프로세스 품질 표준으로 나뉜다.

소프트웨어 제품 패키지 품질은 ISO/IEC 12119를 참조한다.

ISO/IEC 12119는 소프트웨어의 품질 평가를 위해 정보기술과 소프트웨어 패키지에 대한 품질 요구사항 및 시험사항을 규정한 국제 표준이다.

 

1. ISO/IEC 12119 평가 절차

ISO/IEC 12119는 주로 패키지 소프트웨어에 대한 품질 평가에 적용한다.

 

2. ISO/IEC 14598

ISO/IEC 14598는 ISO 9126 규정에 따른다.

ISO/IEC 14598은 개발자에 대한 소프트웨어 제품 품질 향상과 구매자의 제품 품질 선정 기준을 제공한다.