개발자에게 질문할 때 기획자가 꼭 지켜야 하는 '이것'
실제 질문 사례로 알아보는 '개발자에게 질문할 땐 이것만은 지키세요!'
개발자와 소통하다가 모르는 부분이 생길 때 어떻게 질문하면 좋을까요?
IT기획자를 위한 기본 개발지식 세션은 단 2회만에 181명의 현업인이 참여했던 인기 세션입니다. 항상 이 세션에서 등장하는 사전질문 중, 다른 기획자/PM 분들도 어려움을 겪고 있는 문제일거라 생각해서 모두를 위해 오픈된 글을 작성하기로 했습니다.
(새해 1월 6일) 누적 수강생 181명, "IT기획자를 위한 기초 개발지식" 세션 OPEN! 자세히보기
항상 질문을 어떻게 하면 좋을까? 라는 질문에 "구체적으로 대답하세요"라고는 말하지만.. 정작 그렇게 말하는 답변 자체가 구체적이지 않습니다. 그래서 이번에는 그 '구체적'인 대답을 사례를 살펴보며 알려드리겠습니다. 물론, 모든 소통법에 100% 정답이란건 없겠습니다. 다만 제 나름의 경험으로 비추어보아 이렇게 질문하는게 좋았다~라는 경험이니 참고 부탁드릴게요 :)
먼저, 이 글은 아래처럼 기획자가 개발자에게 질문하는 여러 유형중 기술적인 질문 중에서도 '기술적 문제 해결'에 초점이 맞추어져 있습니다. 다른 유형의 질문들도 시리즈로 차차 올리겠습니다.
1. 진행 상황 관련 질문
2. 기술적인 질문
기술 선택과 근거: 특정 기술이나 툴을 사용하는 이유, 다른 대안에 대한 선택 근거를 물을 때
기술적 문제 해결: 어떤 기술적 오류나 문제에 직면했을 때 그 해결 방법에 대한 의견을 확인할 때
3. 요구사항 및 설계 관련 질문
4. 우선순위 및 변경사항 관련
1. 명확하고 구체적으로 질문하기
문제를 명확하게 정의하고, 가능한 구체적으로 설명하세요.
나쁜 질문: "페이지 접속이 안돼요"
좋은 질문: "페이지가 로드되지 않는데 콘솔에 '404 에러'가 표시됩니다"
2. 문제의 맥락과 브라우저 / 기기 OS 알려주기
문제가 발생하는 상황과 배경을 설명하세요. (1)문제가 발생하기 시작한 시점이나, (2)이전에 적용한 변경 사항 등을 제공합니다. 그리고 브라우저와 OS에 따라 특정하게 발생하는 오류일 수 있으니 해당 정보도 제공해주세요.
나쁜 질문: “메인페이지에 떠야하는 팝업이 안떠요”
좋은 질문: “어제 저녁까지만 해도 노트북으로 접속할때 팝업이 떴었는데, 오늘 아침에 휴대폰으로 접속하니까 팝업이 안뜹니다. 참고로 크롬 브라우저 버전 XXX입니다.”
3. 이미 시도한 것과 예상한 결과 설명하기
이미 시도해 본 해결책이 있다면, 어떤 시도를 했는지 설명하고, 왜 그 방법이 작동하지 않는지에 대해 언급합니다.
나쁜 질문: "앱에 접속하고 OO메뉴에 들어가면 그냥 꺼져버리던데요"
좋은 질문: "폰을 껐다가 켜보기도 하고, OS문제인가 싶어서 안드로이드 폰에서도 실행해봤습니다. 그런데도 여전히 그냥 꺼져버립니다."
4. 에러 메시지와 로그 첨부하기
가능하다면 에러 메시지나 로그를 제공하여, 개발자가 문제를 이해하고 분석할 수 있도록 합니다. 웹에선 개발자 도구를 열어서 확인할 수 있습니다.
나쁜 질문: 페이지 접속했더니 화면이 하얗고 그냥 멈춰버려요.
좋은 질문: 개발자 도구로 확인해보니 "Access to XMLHttpRequest at 'https://example.com/api/data' from origin 'https://anotherdomain.com' has been blocked by CORS policy: No 'Access-Control-Allow-Origin' header is present on the requested resource."라는 에러메세지가 뜹니다.
5. 문제를 재현할 수 있는 예시 알려주기
문제를 재현할 수 있는 조건과 상황을 제공하여 개발자가 그 오류를 재현하여 확인할 수 있도록 합니다. 모바일 앱이라면 오류를 재현한 직후 휴대폰을 전달하여 로그를 확인할 수 있도록 돕는 것도 방법입니다.
나쁜 질문: 갑자기 카메라 촬영 버튼 누르면 앱이 꺼져버려요.
좋은 질문: 앱 접속 후 OO탭에서 게시글을 올린 뒤 '다음으로' 버튼을 누르고 카메라 촬영 버튼을 누르면 앱이 꺼져버려요.
6. 고맙다고 표현하기
도움을 요청할 때 정중하고 친절하게, "도움을 주셔서 감사합니다."와 같이 감사의 마음을 표현합니다.
종합 연습
위 내용을 종합하여 잘못된 질문의 예와 좋은 질문의 예로 연습해볼까요?
나쁜 질문
도와주세요, 제 웹페이지가 작동하지 않아요. → 개발자는 당황한다!!
좋은 질문
문제 맥락 제공
안녕하세요 사파리 브라우저 버전XXX을 사용하고 있는데요, 사이트에서 특정 기능을 실행하려고 하는데,
에러 메세지와 로그 첨부
콘솔에 'TypeError: Cannot read property 'someProperty' of undefined' 에러가 발생합니다.
문제를 재현할 수 있는 예시 알려주기
해당 오류는 로그아웃 직후 OO 버튼을 클릭할 때만 발생하는데,
이미 시도한 것과 예상한 결과 설명
오류메세지를 보니 해당 속성이 정의되어 있지 않아서 발생하는 것 같습니다. 로그인을 하고 해보면 잘 동작합니다.
고맙다는 표현
왜 이런 오류가 발생하는 걸까요? 확인 부탁드립니다. 감사합니다!
IT PM/PO/서비스 기획자를 위한 단톡방 오픈
정보 교류와 소통, 직무 스킬 강의 및 웨비나
파이온티어 단톡방 바로가기
