소프트웨어 엔지니어링에서 저평가된 기술: 잘 쓰기 (Writing Well)

Source

  • Evernote/Inbox/Undervalued Software Engineering Skills Writing Well.md

Summary

소프트웨어 엔지니어는 코드 작성에 집중하곤 하지만, 조직이 성장함에 따라 문서화 및 글쓰기 능력의 중요성이 급증한다. 대규모 조직에서는 대면 소통의 한계를 극복하고, 의사결정·가이드라인·사후 분석 등을 지속 가능하게 공유하며, 팀 외부의 엔지니어들에게 영향력을 행사하기 위해 명확한 글쓰기가 필수적이다. 이는 시니어 이상 직급으로 성장하는 데 핵심적인 역량이다. 글쓰기 실력 향상을 위해선 기본 원칙 학습, 독자를 고려한 수정, 간결성 추구, 피드백 수용이 필요하며, 관련 서적과 도구 활용을 권장한다.

Key Points

  • 조직 규모가 커질수록 대면 소통의 한계가 생기고, 글쓰기는 넓은 범위의 엔지니어에게 메시지를 전달하고 영향력을 미치는 핵심 도구가 된다.
  • 의사결정, 트레이드오프, 코딩 가이드라인, 런북, 사후 분석(Postmortem) 등은 글로 남김으로써 지속 가능(Durable)하게 만들어야 한다.
  • 명확하고 간결하게 잘 쓴 글은 독자의 주의를 끌고 오해를 줄이며, 조직 내 커뮤니케이션 효율성을 확장한다.
  • 글쓰기 능력은 시니어 엔지니어에서 리드/스태프/프린시플 엔지니어로 성장하는 데 필수적인 역량이다.
  • 실력 향상을 위해선 기본 원칙 학습, 독자 관점에서의 재수정, 간결성 도전, 피드백 수집이 필요하며, ‘On Writing Well’ 등의 서적과 Grammarly/Hemingway App 등의 도구 활용을 추천한다.