개발자가 읽는 블로그 게시물을 작성하는 방법

1 day ago 5

왜 저자를 믿을 수 있는가

많은 개발자 블로거들이 글 초반에 본론으로 바로 들어가지 않아 독자 이탈을 유발함
독자는 글을 읽기 시작하면서 두 가지 질문에 답을 기대함:
- 이 글은 나 같은 사람을 위한 글인가?
- 이 글을 읽음으로써 나는 어떤 이득을 얻는가?
이 두 질문은 제목과 처음 3문장 안에 답을 줘야 함
독자가 관심 가질 주제와 용어를 사용하고, 지나친 전문 용어나 배경 설명은 피해야 함
글이 주는 이득은 다음과 같을 수 있음:
- 실생활이나 업무에 바로 적용 가능한 기법
- 이해하기 쉬운 개념 설명
- 기술 또는 산업에 대한 통찰
- 공감되는 흥미로운 이야기
예시: “if got, want: A Simple Way to Write Better Go Tests”
- 제목과 첫 문장만으로 다음이 명확함:
  - 대상 독자: Go 언어 사용자
  - 얻는 이득: 30초 만에 새로운 테스트 작성법 배움

대부분의 블로거는 특정 소수의 개발자를 타깃으로 글을 씀 (예: 중상급 Java 개발자)
소폭의 표현 수정만으로 더 넓은 범위의 독자에게 다가갈 수 있음 (예: 모든 Java 개발자 → 모든 개발자 → 기술 관심자)
배경 지식이 없는 독자도 이해할 수 있도록 용어나 설명을 약간 수정하면 도달 범위가 10배로 늘어남
단, 지나치게 범용적으로 확장하면 글의 깊이나 전문성이 떨어질 수 있음
예시: “How I Stole Your Siacoin”
- 원래는 특정 암호화폐 커뮤니티 대상 글이었으나,
- 용어와 설명을 일반화하여 암호화폐를 모르는 사람도 이해 가능하게 수정
- 결과적으로 Reddit, Hacker News 등 다양한 커뮤니티에서 인기글로 등극

글을 잘 썼다고 해도, 사람들이 읽지 않으면 소용없음
구글 검색에서 상위에 노출되기 어려운 주제는 피해야 함
커뮤니티(예: Reddit, Hacker News 등)에 공유할 수 있는 현실적인 계획이 필요함
Reddit 같은 경우, 외부 링크를 허용하지 않거나 엄격한 규칙이 있는 경우가 많음
Hacker News는 튜토리얼이나 너무 흔한 주제에 냉담한 경우가 많음
소셜 미디어에서 공유하더라도 팔로워가 많지 않으면 효과 미미함
현실적인 경로를 설계해야 함
- 주제 선택 전에 글이 어떤 경로로 독자에게 도달할 수 있을지 먼저 고려해야 함
- 다음 질문을 고려:
  - 구글 검색으로 찾기 쉬운 주제인가?
  - 이미 수백 개의 글이 있는 주제는 아닌가?
  - 타겟 독자가 검색할 키워드는 무엇인가?
  - 링크를 공유할 수 있는 커뮤니티가 있는가? 그 커뮤니티가 활성화되어 있는가?
예시: “Using Zig to Unit Test a C Application”
- Zig 언어는 신생 기술로 경쟁 글이 거의 없어 검색 상위 노출 성공
- Hacker News, Lobsters, Reddit (/r/Zig), Ziggit 등에서 링크 공유 가능
- 결과적으로 모든 채널에서 상위 인기 글로 등극

블로그 글에서 가장 효과적인 변화는 이미지 추가임
긴 텍스트만 있는 글은 가독성이 떨어짐
다음과 같은 경우에는 이미지, 스크린샷, 그래프 등을 삽입하면 좋음:
- GUI 프로그램 설명 → 스크린샷
- 수치 변화 설명 → 그래프
- 서버 오류 등 사건 설명 → 대시보드 캡처
- 복잡한 개념 설명 → 도식, 다이어그램
간단한 그림은 Excalidraw 같은 무료 도구 사용 가능
일러스트레이터를 고용하는 것도 좋은 방법 (일러스트당 약 $50~100)
AI 이미지보다 MS Paint 같은 단순한 그림이 더 효과적일 때도 있음

많은 독자는 글을 처음부터 읽지 않고 훑어보며 판단함
스킴만으로 흥미를 유도하려면 다음 요소가 중요함:
- 명확하고 흥미로운 헤딩
- 적절한 이미지와 시각적 단서
- 텍스트만으로 된 긴 단락은 피할 것
도구: 스킴 시점에서 글 확인하기
- 북마클릿(Bookmarklet)을 사용해 글에서 헤딩과 이미지만 보이도록 설정 가능
- 이를 통해 스킴 독자가 보는 구조를 점검할 수 있음
예시: 구조가 지루한 글 vs. 흥미로운 글
- “End-to-End Testing Web Apps: The Painless Way” → 헤딩과 이미지가 매력적이지 않아 실패
- “I Regret My $46k Website Redesign” → 시각적 구조가 흥미를 끌어 성공 (첫 주에 15만 명 읽음)