▲

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

 (refactoringenglish.com)
38P by GN⁺ 3일전 | ★ favorite | 댓글 1개
  • 개발자들이 실제로 읽고 공유하는 블로그 글을 어떻게 써야 하는지에 대한 실용적인 가이드
  • 저자는 9년간의 소프트웨어 블로깅 경험과 수백만 조회수를 바탕으로, 성공적인 포스팅과 실패한 포스팅의 차이를 분석함
  • Hacker News, Reddit, Lobsters 등 개발자 커뮤니티에서 주목받는 글의 공통점과 전략을 알려줌

왜 저자를 믿을 수 있는가

  • 저자는 9년째 개인 개발 블로그 운영 중이며 연간 30만~50만 명의 독자가 방문함
  • Hacker News 첫 페이지에 30회 이상 등장, 그 중 다수가 1위 기록
  • 블로그 포스트 하나로 성공적인 인디 비즈니스 론칭
  • Reddit과 Lobsters 등에서도 꾸준히 언급됨
  • Hacker News 상에서 48번째로 인기 있는 개인 블로그로 평가됨

핵심을 빠르게 전달하기

  • 많은 개발자 블로거들이 글 초반에 본론으로 바로 들어가지 않아 독자 이탈을 유발함
  • 독자는 글을 읽기 시작하면서 두 가지 질문에 답을 기대함:
    • 이 글은 나 같은 사람을 위한 글인가?
    • 이 글을 읽음으로써 나는 어떤 이득을 얻는가?
  • 이 두 질문은 제목과 처음 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만 명 읽음)
▲
GN⁺ 3일전  [-]
Hacker News 의견

  • 일반적으로 블로그 글을 쓸 때는 역피라미드 구조가 가장 적합함. 글의 요점을 빠르게 전달하고, 이후에 자세히 설명하는 것이 중요함. 이렇게 하면 독자가 중간에 글을 그만 읽더라도 중요한 내용을 놓치지 않음

    • 독자를 찾는 문제는 투명성을 유지하는 것이 최선의 해결책임. 역피라미드 형식이 이를 해결함. 관심 없는 사람을 끌어들이는 것은 의미가 없음. 기존 독자를 유지하는 것이 새로운 독자를 끌어들이는 것보다 중요함
    • 이미지 사용에 대해서는 회의적임. 텍스트와 관련이 깊지 않다면 불필요한 삽화는 좋지 않음. 시각적 잡음을 줄이는 것이 중요함. 이미지는 절대 웃기지 않아야 함

  • 반대 의견: 블로그 글을 다른 사람이 읽도록 작성하는 것은 대부분의 사람들에게 글쓰기의 목적을 상실하게 함. 웹상의 대부분의 글은 읽히지 않으며, 읽히기 위해 글을 쓰는 것은 동기부여가 되지 않음

    • 글쓰기는 아무도 읽지 않더라도 매우 가치 있고 재미있음. 글을 쓰는 것은 자신의 생각을 구조화하고 주제와 자신에 대해 더 많이 배우는 것임
    • 개인 블로그에 흥미로운 주제로 글을 쓰는 것이 좋음. 분석 도구를 설치하지 말고, 글을 작성하고 게시한 후 LinkedIn에 올리면 언젠가 누군가가 보고 좋아할 것임

  • AI에게 블로그나 Hacker News, Reddit 글을 비판적으로 평가해달라고 요청하는 것이 효과적이었음. AI의 피드백은 놀라웠고, 저자처럼 글을 썼던 것을 깨달음

  • "자신이 실제로 읽을 글을 쓰라"는 규칙을 따르는 것이 좋음. 우리의 뇌는 우리가 만든 것이 훌륭하다고 착각하게 만듦. 객관적으로 자신의 글을 볼 수 있는 방법을 찾는 것이 중요함

    • 다른 사람이 실제로 읽을 글을 쓰는 것은 더 어려움. 자신이 읽을 글이라면 다른 사람들도 읽을 가능성이 높음

  • Steve Ballmer는 Bill Gates처럼 Microsoft 주식을 다양화하지 않았지만, 그 덕분에 Gates보다 더 부유해짐. 그러나 한 회사에 올인하는 것이 좋은 생각인지는 의문임

    • 글쓰기를 통해 다른 사람에게 유용하게 만드는 것이 중요함. 그러나 더 넓은 독자를 끌어들이기 위해 콘텐츠를 다양화하는 것은 종종 공허하고 공식적인 글이 됨
    • Hacker News는 특정 패턴의 기사를 선호함. 대부분은 기억에 남지 않음. 댓글에서 더 많은 것을 배움
    • 현재 작업 중이거나 관심 있는 주제에 대해 글을 씀. 과거의 자신에게 유용할 것 같은 내용을 작성함. 이는 독자를 위해 글을 작성하는 것과는 다름

  • 개인적으로 글에 열정이 있어야 함. 그렇지 않으면 독자들이 이를 알아차리고 비판할 것임. 글쓰기는 자신을 위한 것이어야 함

  • 블로그 글은 항상 짧아야 하는가? 긴 글이 필요한 경우도 있는가?

  • Hacker News의 독자들은 일반적으로 암호화폐 관련 이야기에 적대적임에도 불구하고, 기사가 첫 페이지에 도달함

  • 블로그 글을 개발자가 읽고 공유하게 만드는 두 가지 방법이 있음

    • 많은 글을 작성하여 결국 성공적인 글을 찾는 것
    • 연구와 노력을 기울여 글을 작성하는 것
    • 두 번째 접근 방식을 집중적으로 사용함. 각 글을 자랑스럽게 만들기 위해 많은 시간을 들임. 구조를 조정하고, 간결하게 만들고, 스캔 가능성을 높이기 위해 노력함

  • 인기 있는 블로그는 제안된 것과 반대되는 방식을 취하는 경우가 많음. 그러나 스타일을 찾고 인기를 최적화하려는 사람들에게는 유용한 조언임

답변달기