개발자가 질문을 잘 하는 법

찾아보게 된 동기

패스트캠퍼스 조교 활동을 하며 만나게 되었던 수강생이었고 지금은 개발자 분들과 평소 다양한 주제로 이야기를 하던 중 한 분이 질문에 대한 영상을 링크와 함께 올려주셨고 평소 질문 공포증이 있는 나를 위해 영상을 듣고 다른 사람들과 공유하고자 글을 올립니다.

• 동영상 1 - 코드 스쿼드
• 동영상 2 - 삼평동 연구소

해당 글은 링크를 포함한 영상 안에서 작성자가 중요하다 생각한 것을 작성자의 해석에 따라 요약 및 작성하였습니다. 보다 정확한 내용은 첨부한 링크를 통해 직접 시청하시길 권유합니다.

해당 인터넷 영상은 stack over flow에 글을 올리는 방법에 대한 영상이라는 느낌이었다.
질문을 하기 위해 질문을 작성하다 보면 90%의 문제가 해결이 된다는 말씀은 정말 공감이 간다.

동영상 1

1단계: 질문을 하기 전에 해야 할 것들

• 5 Why 원칙에 따라 생각을 해 보기
• 삼 세번
  • 해결이 될 법한 다른 방법을 세 가지 시도
  • 추후에 질문에 포함시키면 좋다.
• 그래서 해결이 되었다면??
  • 공유하자!

2단계: 이제 검색을 해 보자

내가 모르는건 남이 실수한다.
구글은 랭크 검색이라는 과정을 통해 우리의 질문은 첫 페이지 안에 있다.

google - stack over flow ~

3단계: 그래도 해결이 되지 않았다면 질문을 하자!

제목을 잘 지어야 한다.

# ex - bad: 프로그램이 안돌아가요 - good: int 나누기 int 결과값이 이상하게 나오는 이유는 무엇인가요? - bad: [node] 세션 문제 도와주세요 - good: [node] 페이지 리다이렉트를 해도 세션을 유지하려면?

제목이 잘 떠오르지 않을 떄에는 본문을 먼저 작성하자.

본문은 코드보다 상황을 먼저 설명하며 재현 가능하도록 코드를 구체적으로 작성해야 하며
발생한 에러 메시지는 정확하게 첨부해야 한다.

질문에 반드시 포함되어야 하는 내용

• 언어 및 버전
• 플랫폼 환경
• 운영체제 및 환경
• 질문과 관련된 소프트웨어의 스펙
• 기타 중요한 제약 조건

좋은 질문을 했다면

• 질문을 작성하기 위해 매우 긴 시간이 필요하다.
• 답변자도 질문자를 위해 긴 시간을 사용한다.
• 질문을 하는 것 자체가 실력 향ㅅ아에 큰 도움을 준다.
• 질문과 해결이 된 답변은 언젠가 다른 개발자에게 도움을 준다.
  • 이미 여러분은 개발자 세상에 기여를 하는 것이다.

동영상 2

1. 기한을 정해놓고 최대한 확인하고 질문하기 - 원칙을 생략하지 말자

문서, 구글링, 기술 서적 등 프로토 타이핑, 디버깅, 테스트 등 다양한 원칙을 정해놓고 엄격하게 절차를 밟아 나아가며 확인을 해야 할 것들을 확인하지 않는 실수를 범하지 않는다.

상황이 급박할수록 원칙을 어기지 않고, 해야할 것을 다 지켜서 하는 것이 그 문제를 제대로 해결 할 수 있는 방법일 수 있다.

또한 기한을 정한다는 것은 마감일 당일에 질문을 하는 것이 아닌 분석 기간안에 솔루션이 나오지 않는 다면 이것이 위급한 순간이라는 것을 자각해야 하는 것 이다.

2. 명확한 질문을 하기

최소한의 확인도 하지 않고 질문을 하는 경우라면 질문을 받는 당사자는 그 사람을 어찌보면 쉬운길만 선택하는 얄미운 사람, 협업에 대한 자세가 부족한 사람이라 판단을 할 수 있다.
이것은 내가 패스트캠퍼스의 조교를 하며 실제 경험을 하기도 했던 순간이며 패스트캠퍼스 조교 활동을 통해 배운 가장 큰 교훈이기도 하다.

질문자는 질문을 위해 충분한 시간과 노력을 들여야 한다.

3. 질문에 자신의 의견을 준비하기

질문자는 질문에 대한 내용과 함께 자신이 시도한 방법과, 이후에 자신이 시도하고자 하는 방법에 대한 내용도 함께 질문하며 조언을 얻는 과정은 답변자와 보다 건설적인 대화를 이어갈 수 있으며 위 2. 명확한 질문하기 와 이어지는 내용이다.

4. 똑같은 질문을 하지 않기.

지난 질문을 또 다시 했다고 해서 그것이 반드시 잘못된 것은 아니다.
하지만 질문자가 답변자를 통해 해결했던 문제를 또 다시 질문하게 된다면 심지어 그 과정을 반복한다면 팀원들은 질문자의 태도를 통해 경험에 대한 학습의지가 부족한 사람이라는 오해를 가질 수 있다.

온전히 내 것으로 만드는 자세가 굉장히 중요하다. 지난 답변이 명확하게 이해가 되지 않았다면 구제척으로 다시 한번 내용을 정리하여 물어보는 태도를 가지자.

본인이 질문을 통해 해결한 문제들이 있다면, 반드시 문서화 하는 습관을 가져보자