"개발자 블로그가 유독 읽기 힘든 이유" 글쓰기 안티패턴 모음

요약 개발자 블로그를 읽다 보면 서론만 하염없이 길거나 무슨 말인지 모를 전문 용어로 도배되어 뒤로가기를 누르게 되는 경우가 흔합니다. 테크 글쓰기 전문 블로그 'Refactoring English'에서는 개발자들이 블로그를 쓸 때 무의식적으로 범하는 치명적인 안티패턴들을 정리했습니다. 가장 흔한 실수는 본론으로 바로 들어가지 않는 '장황한 서론'입니다. 배경 설명이나 개인적인 역사 등을 장황하게 늘어놓지만, 독자 입장에서는 읽어야 할 글이 수없이 많기 때문에 첫 세 문장 안에 '이 글이 나를 위한 글인지'와 '무엇을 얻어갈 수 있는지'가 드러나지 않으면 바로 이탈합니다. 매력적인 도입부를 써놓고도 쓸데없는 부제, 긴 프로필, 명언 등을 덕지덕지 배치해 독자의 집중력을 갉아먹는 것도 같은 문제입니다. 또한 '독자가 나만큼 알 것'이라는 착각도 큰 문제입니다. 도커(Docker)를 초보자에게 설명하면서 리눅스 cgroups나 BSD jail 같은 더 생소한 개념을 끌어와 설명하는 식입니다. 독자의 수준을 과대평가하기보다는 실제 주변 동료나 친구 한 명을 떠올리며 그 사람이 아는 단어와 모르는 단어를 구분해 설명 수위를 조절해야 합니다. 모르는 용어를 직접 설명하지 않고 링크 하나 덜컥 달아놓는 '링크 남발' 역시 지적되었습니다. 방화벽 개념을 설명하겠다며 수만 단어짜리 공식 매뉴얼 링크를 던져버리면 독자의 읽기 흐름이 완전히 끊어지기 때문입니다. 외부 링크로 책임을 떠넘기지 말고, 본문 흐름에 맞게 한두 줄로 핵심 개념을 직접 요약해 주는 것이 좋은 테크 블로그의 핵심이라고 조언합니다.