1장. 개발자에게 블로그란

1.1 왜 개발자는 글을 써야 하는가

개발자에게 글쓰기란 무엇일까요. 코드를 잘 짜면 그것으로 충분하다고 생각하기 쉽습니다. 하지만 실제 현업에서는 코드를 작성하는 시간만큼, 혹은 그 이상으로 글을 쓰는 시간이 많습니다. 설계 문서, 코드 리뷰 코멘트, 장애 보고서, 회의록, 팀 위키 등 개발자가 작성하는 글의 종류는 생각보다 다양합니다.

IEEE 연구에 따르면 초급 엔지니어는 업무 시간의 약 30%를 글쓰기에 씁니다. 중간 관리자는 50에서 70%, 시니어 관리자는 70에서 95%를 글쓰기에 보냅니다. 직급이 올라갈수록 코드보다 글을 쓰는 시간이 압도적으로 늘어납니다. 글쓰기는 시니어로 성장하기 위해 반드시 갖춰야 할 역량입니다.

다음 그림은 개발자 직급별 글쓰기와 코딩의 시간 비중을 보여줍니다.

주니어 개발자는 업무 시간의 70%를 코딩에 쓰지만, 시니어 관리자가 되면 그 비율이 역전되어 95%까지 글쓰기에 할애합니다. 코딩 실력만으로는 시니어로 성장할 수 없다는 것을 보여주는 데이터입니다.

그런데 글쓰기 역량은 어디서 기를 수 있을까요. 회사의 기술 문서는 마감과 형식에 쫓기기 마련입니다. 블로그는 다릅니다. 주제를 자유롭게 고를 수 있고, 형식에 제약이 없고, 실패해도 부담이 없습니다. 글쓰기 근육을 키우기에 가장 적합한 공간입니다.

이 절에서는 개발자가 글을 써야 하는 구체적인 이유를 살펴봅니다. 글쓰기가 왜 필수 역량인지, 블로그가 왜 학습에 효과적인지, 그리고 지금 바로 시작하려면 무엇부터 하면 되는지를 다룹니다.

1.1.1 글쓰기는 개발자의 필수 역량이다

주니어 개발자 시절에는 코드 작성 능력이 곧 실력입니다. 주어진 기능을 정확히 구현하고, 버그를 빠르게 수정하고, 코드 품질을 높이는 것이 가장 중요합니다. 하지만 시간이 지나고 경험이 쌓이면 상황이 달라집니다. 팀을 이끌고, 프로젝트 방향을 결정하고, 기술 전략을 수립하는 역할을 맡게 됩니다. 이 모든 일에는 글쓰기가 필요합니다.

설계 문서를 작성하는 일을 생각해 봅니다. 팀원 10명이 각자 다른 해석을 하지 않도록, 기술적 결정의 근거를 명확히 남겨야 합니다. "왜 이 데이터베이스를 선택했는지", "왜 이 아키텍처가 적합한지"를 논리적으로 서술해야 합니다. 장애가 발생하면 원인 분석과 재발 방지 대책을 문서로 정리해야 합니다. 새로운 기술 도입을 제안할 때는 비교 분석 자료를 작성해야 합니다. 이 모든 것이 글쓰기입니다.

코드는 기계가 읽는 언어입니다. 글은 사람이 읽는 언어입니다. 시니어 개발자가 되려면 두 언어 모두 능숙해야 합니다. 코드로 문제를 해결하는 능력과 그 해결 과정을 동료에게 설명하는 능력은 별개입니다. 후자를 연습할 수 있는 가장 좋은 방법이 블로그입니다.

Jeff Atwood는 블로깅이 자신의 커리어에서 가장 잘한 일이라고 말했습니다. 그가 운영한 Coding Horror 블로그는 결국 Stack Overflow의 탄생으로 이어졌습니다. 글쓰기가 단순한 기록 행위가 아니라 커리어를 바꾸는 힘이 된 사례입니다.

글쓰기의 효과는 블로그 바깥에서도 나타납니다. 글을 쓰는 습관이 있는 개발자는 코드 리뷰 코멘트도 명확하게 작성합니다. 풀 리퀘스트 설명도 구체적으로 적습니다. 슬랙 메시지 하나를 보내더라도 상대방이 한 번에 이해할 수 있도록 정리합니다. 글쓰기 연습은 개발자의 모든 커뮤니케이션을 개선합니다.

블로그는 커리어 기회도 만들어 줍니다. Adam DuVander는 웹몽키에 쓴 튜토리얼 하나 덕분에 첫 번째 개발자 일자리를 얻었습니다. Stephanie Morillo는 블로그 게시물만으로 스타트업에서 정규직 제안을 받았습니다. Stack Overflow Blog의 한 저자는 PHP Docker 관련 글을 써서 책을 출판하고 컨퍼런스에서 발표할 기회를 얻었습니다. 이들은 유명한 개발자가 아니었습니다. 꾸준히 글을 쓴 개발자였습니다.

1.1.2 블로그는 가장 효과적인 학습 도구다

블로그 글쓰기가 학습에 효과적인 이유는 단순합니다. 설명할 수 없는 것은 이해하지 못한 것이기 때문입니다. 새로운 기술을 배우고 글로 정리하는 과정에서 지식의 빈틈이 드러납니다. 그 빈틈을 채우는 것이 진짜 학습입니다.

문서를 읽고 "이해했다"고 느끼는 것과, 그 내용을 다른 사람에게 설명할 수 있는 것 사이에는 큰 차이가 있습니다. 블로그 글을 쓰려면 머릿속 지식을 꺼내서 논리적인 순서로 배열해야 합니다. 이 과정에서 "사실은 이 부분을 정확히 모르고 있었구나"라는 깨달음이 찾아옵니다. 그 깨달음이 학습의 시작입니다.

왜 블로그 글쓰기가 학습을 깊게 만드는가

블로그 글쓰기가 좋은 학습 도구인 이유는, 내가 아는 것을 "남이 이해할 수 있는 말"로 바꿔야 하기 때문입니다. 머릿속에서는 이해한 것처럼 느껴졌던 개념도 막상 글로 쓰려면 빈틈이 바로 드러납니다. 예를 들어 HTTP 요청 흐름을 설명하다가 DNS 조회 이후 과정을 막연하게 알고 있었다는 사실을 깨닫는 식입니다. 이처럼 막히는 지점이 바로 다음 학습 과제가 됩니다.

또한 글은 미래의 나를 위한 가장 실용적인 기록입니다. 개발자는 같은 문제를 몇 달 뒤에 다시 만나는 일이 흔합니다. 그때 과거의 내가 남겨 둔 정리 글이 있으면, 처음부터 다시 헤매지 않아도 됩니다. "분명 전에 해결했는데 기억이 안 난다"는 시간을 줄여 주는 것이죠.

마지막으로, 내가 정리한 글은 다른 개발자에게도 도움이 됩니다. 특히 막 배운 사람이 쓰는 글은 같은 단계의 독자에게 큰 가치를 줍니다. 전문가에게는 너무 당연해서 생략되는 부분을, 초보자의 시선은 더 자세히 설명해 주기 때문입니다.

글감은 일상 업무에서 나온다

블로그 글감은 거창한 주제에서 나오지 않습니다. 오늘 배운 것, 오늘 막혔던 것, 동료에게 설명했던 것에서 바로 나옵니다. 예를 들어 Git rebase를 배우는 날이라면, 개념 정의부터 완벽하게 쓰려고 하기보다 "왜 rebase를 하게 되었는지, 어디서 충돌이 났는지, 어떻게 복구했는지, 다음에 무엇을 조심할지"를 순서대로 적는 편이 훨씬 유익합니다.

트러블슈팅 글도 같은 방식으로 풀어낼 수 있습니다. "Docker 컨테이너에서 한글 로그가 깨졌다"는 상황을 만났다면, 증상만 적고 끝내지 말고 원인을 어떻게 좁혀 갔는지까지 남기는 것이 좋습니다. 처음에는 인코딩을 의심했고, 로컬과 컨테이너의 차이를 비교했고, 마지막에 로케일 설정 누락을 확인했다는 흐름을 써 두면, 비슷한 문제를 겪는 사람에게 바로 도움이 됩니다.

비교 글도 문장으로 자연스럽게 쓸 수 있습니다. 예를 들어 npm과 yarn을 다룬다면 "설치 속도, 잠금 파일, 팀에서의 사용 경험" 같은 비교 기준을 먼저 제시하고, 끝에서는 "내 프로젝트에서는 왜 이 선택을 했는지"를 분명히 밝히는 식입니다. 비교 자체보다 선택의 이유를 드러낼 때 글의 관점이 살아납니다.

오래 쓰려면 완벽보다 리듬이 먼저다

글쓰기를 오래 이어 가는 핵심은 완성도가 아니라 리듬입니다. Jeff Atwood가 강조한 것도 결국 "일정을 정하고 지키는 습관"이었습니다. 매일 길게 쓰는 것보다, 짧더라도 주 1회 꾸준히 쓰는 편이 훨씬 강력합니다.

시작이 어려울 때는 가장 최근에 해결한 문제 하나만 짧게 적어도 충분합니다. "어떤 문제가 있었고, 어떻게 해결했는지"를 한 문단으로 남기는 습관이 쌓이면 글쓰기에 대한 부담이 크게 줄어듭니다. 처음부터 완벽한 글을 쓰겠다는 목표는 대개 시작 자체를 늦춥니다.

발행 리듬을 유지하려면 운영 방식도 단순해야 합니다. 발행일 직전에 급하게 마무리하기보다 며칠 전에 초안을 써 두고 다듬는 편이 안정적입니다. 또 주제를 너무 넓히지 않는 것이 좋습니다. 여러 분야를 한꺼번에 다루기보다, 자신이 실제로 자주 다루는 기술을 중심으로 써야 블로그의 색이 선명해지고 독자도 꾸준히 쌓입니다.

1.1.3 정리

개발자에게 글쓰기는 선택이 아니라 필수 역량입니다. 직급이 올라갈수록 글쓰기 비중이 높아지고, 블로그는 이 역량을 가장 부담 없이 연습할 수 있는 공간입니다. 배운 것을 정리하고, 겪은 문제를 기록하고, 꾸준히 쓰는 습관을 들이는 것이 블로그의 시작입니다.

참고 문헌

• How writing can advance your career as a developer - Stack Overflow Blog
• Every Developer Should Have a Blog - freeCodeCamp
• How to Achieve Ultimate Blog Success in One Easy Step - Coding Horror