제품 소프트웨어 패키징 패키징하기 2/3

제품 소프트웨어 패키징 패키징하기

버전을 고려한 제품 릴리즈 노트 작성

릴리즈 노트

릴리즈 노트(Release Note)의 개념

• 최종 사용자인 고객에게 개발 과정에서 정리된 제품의 릴리즈 정보를 제공하는 문서
• 릴리즈 정보는 상세 서비스 정보를 포함하여 제품의 수정, 변경, 개선하는 일련의 작업에 대한 정보이며, 릴리즈 노트를 통해 제공

릴리즈 노트의 중요성

정보 제공

• 최종 배포된 릴리즈 노트에는 테스트 진행 과정, 테스트 결과, 개발팀의 제공 사양 준수 정도를 파악할 수 있음
• 사용자에게 더 자세하고 확실한 정보를 제공
• 기본적으로 전체적인 제품의 수행 기능 및 서비스의 변화를 공유

관리의 용이성

• 전체적인 버전 관리 및 릴리즈 정보를 체계적으로 관리

릴리즈 노트 작성 시 고려 사항

• 현재 시제로 작성되어야 하며, 배포 시부터 신규 소스, 빌드 등 이력을 명확하고 정확하게 제공
• 개발자와 테스터가 함께 협업해야 하고 최초 및 변경, 개선 항목까지 연결되어 다음 항목에 대한 정보들이 릴리즈 노트를 통해 작성되어야 함
• 개발팀에서 직접 작성하여야 함

릴리즈 노트 작성 항목

• 헤더 : 문서 이름(릴리스 노트 이름), 제품 이름, 버전 번호, 릴리즈 날짜, 참고 날짜, 노트 버전 등의 정보
• 개요 : 제품 및 변경에 대한 간략한 전반적 개요
• 목적 : 릴리스 버전의 새로운 기능목록과 릴리스 노트의 목적에 대한 개요, 버그 수정 및 새로운 기능 기술
• 이슈 요약 : 버그의 간단한 설명 또는 릴리즈 추가 항목 요약
• 재현 항목 : 버그 발견에 따른 재현 단계 기술
• 수정개선 내용 : 수정개선의 간단한 설명 기술
• 사용자 영향도 : 버전 변경에 따른 최종 사용자 기준의 기능 및 응용 프로그램상의 영향도 기술
• 소프트웨어 지원 영향도 : 버전 변경에 따른 소프트웨어의 지원 프로세스 및 영향도 기술
• 노트 : 소프트웨어와 하드웨어 설치 항목, 제품, 문서를 포함한 업그레이드 항목 메모
• 면책 조항 : 회사 및 표준 제품과 관련된 메시지, 프리웨어 및 불법 복제 방지, 중복 등 참조에 대한 고지 사항
• 연락 정보 : 사용자 지원 및 문의에 관한 연락처 정보

릴리즈 노트 예외 케이스

테스트 단계에서의 베타 버전 출시

• 제품 소프트웨어의 차기 버전이나 신규 버전의 베타 버전 테스트 단계에서도 릴리즈 버전으로 정보를 체크하여 릴리즈 노트를 작성
• 자체에서 기준을 수립하여 현 베타 버전을 신규 소스로 하여 릴리즈할지, 예외 사항으로 베타 버전에 대한 릴리즈 노트를 따로 만들지 사전에 정의해야 함

긴급 버그 수정 시

• 보통 긴급히 버그가 수정되면 릴리즈 노트 작성을 놓치는 경우가 많기 때문에 버그 번호를 포함한 모든 수정된 버그를 기술하여 릴리즈 노트에 추가

자체 기능 향상을 포함한 모든 추가 기능의 향상

• 자체적으로 기능 개선을 완료했을 때 정식으로 릴리즈 버전을 추가하고, 이에 따른 신규 릴리즈 노트를 작성
• 업그레이드는 소프트웨어 및 하드웨어에 대한 항목까지 포함

사용자 요청에 따른 특이한 케이스 발생

• 제품 소프트웨어가 사용자에게 배포됨에 따라 기존에 배포된 릴리즈 노트의 연락처 정보를 통해 사용자의 의견이 접수된 경우
• 개발팀 내부에서 허용되는 범위 내에서 요청이 접수될 경우 이를 자체 기능 향상과는 별도의 버전으로 새로 추가하여 릴리즈 노트를 작성

릴리즈 노트 작성 프로세스

1. 모듈 식별

• 릴리즈 노트 작성을 위한 모듈 및 빌드 정리
• 입출력 데이터, 전체적인 기능 정의, 데이터 흐름 정리
• 기능 단위 및 출력에 대한 상세 정의

2. 릴리즈 정보 확인

• 문서 이름(릴리스 노트 이름), 제품 이름 정보 확인
• 버전 번호, 릴리즈 날짜 확인
• 참고 날짜, 노트 버전 확인

3. 릴리즈 노트 개요 작성

• 제품 및 변경에 대한 간략한 전반적인 개요 작성
• 개발 소스의 빌드에 따른 결과물 기록
• 버전 및 형상 관리에 대한 전반적인 노트 기록

4. 영향도 체크

• 버그의 간단한 설명 또는 릴리즈 추가 항목 기술
• 버그 발견을 위한 재현 테스트 및 재현 환경을 기록
• 소프트웨어 및 사용자 입장에서의 영향도 파악

5. 정식 릴리즈 노트 작성

• 릴리즈 정보, 헤더 및 개요 등 기본사항 기술
• 정식 버전을 기준으로 릴리즈 노트 개요 작성
• 이슈, 버그 등 개서 내용 기술

6. 추가 개선 항목 식별

• 추가 개선에 대한 베타 버전을 이용한 테스트 수행
• 테스트 중에 발생한 긴급 버그 수정
• 추가 기능 향상을 위해 작은 기능 수정
• 사용자 요청에 따른 추가 개선