[IREB CPRE] Chapter 3. Work Products and Documentation Practices 1️⃣

🟡 3.1 Work Products in Requirement Engineerting

 

✅ 3.1.1 Characteristics of Work Products

 

 

* Lifespan을 기준으로 구분될 수 있는 Work Product의 3가지 유형 *

1) Temporary work products : 의사소통 및 share understanding을 보조하기 위해 만들어지는 work product로서 사용된 이후에 폐기됨.

2) Evolving work products : 몇 번의 반복을 통해 나타나는 work product로서 최소한의 metadata는 보존되어야 함. 

3) Durable work products : baselined or released된 work product로서 모든 metadata가 반드시 보존되어야 함.

 

 

 

 

✅ 3.1.2 Abstraction Levels

 

 

 

 

✅ 3.1.3 Level of Detail

 

세부사항 레벨에 영향을 미치는 요인들

 

 

 

✅ 3.1.4 Aspects to be Considered

 

1. Functional Requirement의 3가지 주요 aspects

 

2. Quality Requirements 중 performance requirements의 중요 포인트

 

'-> Quality Requirements를 문서화하는 것은 어렵기로 악명높다.(notorious)

 

Qualitative representations는 위와 같은 상황에서 충족됨

 

3. Constraints를 분류할 때 고려되어야 할 항목

 

aspects 간의 연관성과 의존성 예시

 

 

 

 

✅ 3.1.5 General Documentation Guidelines

 

General guidelines

 

 

 

✅ 3.1.6 Work Product Planning

 

RE Work products를 미리 정의

 

 

 

🟡 3.2 Natural-Language-Based Work Products

* 자연어로 요구사항 작성시 주의할 사항 : short sentences, well-structured, structured work products, define terminology, creating glossary, avoid ambiguous phrases

 

* 반드시 피해야 할 것 : incomplete descriptions, unspecific nouns, incomplete conditions, incomplete comparison

 

 

-> 불완전한 설명은 노노, 예를들어 give라는 단어 쓸 때 어디서 줬고 누가 줬고 어떻게 줬는지가 다 있기 때문에 상세히 설명 필요

-> 상세하지 않은 명사 사용 지양, 예를들어 'the data'와 같은건 너무 광범위함.

-> 불완전한 조건도 노노

-> 어정쩡하게 비교하지마, 'the new video is much better'과 같은 문장은 최악. 도대체 뭐보다 얼마나 어떻게 더 나은지 쓰기

 

 

* 요구공학자가 조심해서 사용해야할 것들 : passive voice, universal quantifier, nominalizations

 

-> 수동적인 문장으로 쓰지 말 것. 책임이 어디에 있는지 명시할 필요가 있음.

-> 전칭 기호(all, always, never)사용 지양할 것. 얼만큼의 범위 안에 들어가있는지 구분하기 어렵기 때문.

-> 명사화 하지 말 것. 이렇게 되면 명시되지 않은 요구사항을 포함할 수도 있기 때문.

예를 들어, "only after authentication, we can use~~"면 저 인증 절차가 존재한다는 것을 암시함.  그렇기 때문에 이런거 없이 다 잘 설명될 수 있도록 해야함.

 

 

 

🟡 3.3 Template-Based Work Products

✅ 3.3.1 Phrase Templates

 

 

🔆 3.3.1.1 Phrase Templates for Individual Requirements

조동사 사용

 

EARS templates

 

 

 

🔆 3.3.1.2 Phrase Templates for User Stories

Cohn's user story templates

 

-> 모든 user story는 'acceptance criteria'가 동반되어야 함.

 

 

 

✅ 3.3.2 Form Templates

 

use case를 작성하기 위한 기본 form

 

quality requirements template

 

 

 

✅ 3.3.3 Document Templates

 

 

 

✅ 3.3.4 Advantages and Disadvantages

 

-> template을 사용하면 clear, re-usable structure for work products, make them look uniform, improve readability의 장점이 있지만, 너무 기계적으로 이 틀을 맞추려다가 안에 내용을 소홀히 하게 되면 오히려 중요한 부분을 놓치게 될 수 있다는 단점이 있음.

 

 

 

 

 

 

Reference

Handbook for the CPRE Foundation Level according to the IREB Standard

Version 1.1.0

September 2022

 

위 책 내용을 챕터별 중요한 포인트 위주로 screenshot을 통해 정리한 자료입니다.

스스로 공부하기 위한 요점정리 노트이므로 상업적인 사용 목적은 전혀 없음을 알려드립니다:)

 

이 시험에 대한 정보 및 각종 자료는 아래 사이트에서 확인하실 수 있습니다. ⬇⬇⬇

http://www.kstqb.org/sw/lreb.asp