쓰기 · 무료 레슨
버그 보고: 예상 결과와 실제 결과 구분하기
“내보내기가 안 돼요”만으로는 동료가 무엇을 확인해야 할지 알기 어려워요. 두 결과를 비교하면 차이가 드러나요.
Scott Mendoza 교수핵심 정리
Expected result에는 의도한 동작을, Actual result에는 관찰한 결과를 적어요. 그 결과가 나온 실행 단계를 덧붙이고 추측한 원인은 따로 구분하세요.
의도한 결과와 실제 관찰한 결과를 비교하세요.
요구사항에는 Export를 누르면 CSV 파일이 다운로드돼야 한다고 적혀 있어요. 그런데 테스트에서는 빈 페이지가 나타나요. 요구사항은 Expected, 빈 페이지는 Actual에 적어요. 한국어의 “안 돼요”를 그대로 옮기기보다 화면에서 무엇이 보였는지 설명하세요. 이 관찰만으로 원인이 된 코드를 알 수는 없어요.
동료가 확인할 수 있는 보고
Clicking Export should download a CSV file.
Clicking Export shows a blank page.
여기서 should는 실제로 본 결과가 아니라 의도한 동작을 나타내요. Observed는 이번 테스트에서 관찰했다는 뜻이며 항상 그렇다는 뜻은 아니에요.
문제가 나타나기까지의 단계
실행 단계
Open the report and click Export.
관찰 결과
In this test, a blank page appears instead of a download.
지금 연습해 보세요
버그 보고에 맞는 문장 고르기
전체 정답과 해설 보기
요구사항은 CSV 다운로드예요. Expected에 들어갈 문장은 무엇인가요?
Clicking Export should download a CSV file.Should는 의도한 결과를 나타내요. 빈 페이지는 관찰 결과이며 서버 진단은 아직 확인되지 않았어요.
한 번의 테스트에서 빈 페이지가 나왔어요. 정확한 Actual 문장을 고르세요.
In this test, clicking Export shows a blank page.두 번째 문장은 이번 테스트를 설명해요. Always와 everyone은 근거보다 범위가 넓고 should work는 기대하는 동작이에요.
원인을 조사하지 않았어요. 그 불확실성을 유지하는 문장은 무엇인가요?
The cause is not yet confirmed.마지막 문장만 원인을 미확인 상태로 남겨 둬요. 나머지는 근거 없이 특정 구성요소를 원인으로 지목해요.
직접 연습하기
버그 보고 고치기
Save는 새 주소를 저장해야 해요. 하지만 이번 테스트에서는 저장 후에도 이전 주소가 남아 있어요. 원인은 몰라요. 가장 유용하고 사실에 맞는 보고를 고르세요.
The database is broken. Save does not work.
예시 답변 보기
Expected: Save should keep the new address. Actual: the old address remains after saving. The cause is not yet confirmed.
다른 명확한 표현도 가능해요. 의도한 동작과 관찰한 동작을 구분하고 없는 원인을 넣지 않는 것이 핵심이에요.
조금 더 알아보기
자주 묻는 질문
다음으로 넘어가기 전에 알아두면 좋은 내용입니다.
Actual은 반드시 과거형으로 써야 하나요?
아니요. 반복 확인할 수 있는 결과는 현재형으로, 이미 끝난 테스트는 과거형으로 설명할 수 있어요. 의미와 테스트 조건을 명확히 하세요.
The old address remained after I clicked Save.
버그의 원인이라고 생각하는 내용도 적어도 되나요?
가능한 원인을 가설로 표시할 수는 있지만 실제로 관찰한 결과와 구분하세요. 보고서를 읽는 사람이 확인된 현상과 아직 확인해야 할 추측을 구별할 수 있어야 해요.
일상에서 사용해 보세요
Expected는 의도한 결과, Actual은 관찰한 결과예요. 어느 쪽도 원인 자체를 입증하지는 않아요.
직무별 영어 · 출시 예정
소프트웨어 업무의 대화를 연습해 보세요.
English for Software Engineers: Career Simulation은 출시 예정이에요. 요구사항, 리뷰, 테스트, 릴리스에 관한 상황을 다룰 계획이에요.
출시 소식 받기소프트웨어 엔지니어 · 직무 시뮬레이션
다음 학습 · Udemy에서 수강 가능
업무에 필요한 문장 구성의 기초를 쌓으세요.
현재 수강 가능한 English Grammar and English Speaking Master Course에서 문장 구성, 어휘, 비즈니스 의사소통의 기초를 배울 수 있어요. 전반적인 영어를 다루는 강좌이며 이 전문 직무 시뮬레이션과는 별개예요.
강좌 살펴보기 English Master Course: 영문법과 영어 말하기