처리중입니다. 잠시만 기다려주세요.
TTJ 코딩클래스
정규반 단과 자료실 테크 뉴스 코딩 퀴즈
테크 뉴스
Hacker News 2026.05.29 36

글쓰기가 재능이라고요? 사실은 '배울 수 있는 기술'입니다

Hacker News 원문 보기

글쓰기가 싫었던 어느 연구자의 고백

개발자라면 한 번쯤 겪어봤을 거예요. 코드는 어떻게든 굴러가게 만들겠는데, 막상 그 코드를 설명하는 PR 설명이나 기술 문서, 장애 회고를 쓰려고 하면 커서만 깜빡이고 머릿속이 하얘지는 순간이요. 이 글은 평생 글쓰기를 싫어했던 한 연구자가 '글쓰기에도 과학이 있다'는 걸 알게 된 뒤로 생각이 완전히 바뀐 이야기인데요. 핵심 메시지는 딱 하나예요. 좋은 글은 타고난 재능이 아니라 배울 수 있는 원리의 모음이라는 것. 우리가 글을 못 쓰는 게 아니라, 아직 그 원리를 안 배운 것뿐이라는 거죠.

첫 번째 함정, '지식의 저주'

가장 먼저 나오는 개념이 '지식의 저주(curse of knowledge)'예요. 이게 뭐냐면, 내가 어떤 걸 알고 나면 그걸 모르던 시절의 내 머릿속을 도무지 상상하지 못하게 되는 현상이에요. 그래서 글을 쓸 때 자꾸 '이 정도는 당연히 알겠지' 하고 설명을 슬쩍 건너뛰게 되거든요. 우리가 정성껏 쓴 기술 문서를 신입이 읽고 멍한 표정을 짓는 이유가 대부분 여기 있어요. 글쓴이한테는 너무 당연한 배경 맥락이, 읽는 사람한테는 통째로 빠져 있는 거죠. 그래서 글을 다 쓰고 나면 '이 글을 처음 보는 사람이 정말 이해할까?'를 한 번 의심해보는 습관이 중요해요.

글을 '창문'처럼 쓰기

두 번째는 심리학자 스티븐 핑커가 말한 '고전적 문체(classic style)'예요. 글을 독자에게 무언가를 보여주는 창문이라고 생각하라는 건데요. 내가 얼마나 똑똑한지, 얼마나 어려운 일을 했는지 뽐내는 도구가 아니라, 독자가 내가 본 것을 똑같이 볼 수 있게 도와주는 투명한 유리창이라는 거죠. 이 관점 하나만 가져도 문장이 확 달라져요. '본 작업에서는 ~을 수행하였음' 같은 무겁고 격식 차린 문장 대신, '우리는 ~를 발견했어요'처럼 독자에게 바로 보여주는 문장이 나오거든요.

흐름의 비밀, 구정보 → 신정보

가장 실용적인 팁은 '구정보-신정보(given-new)' 원리예요. 문장을 시작할 때는 독자가 이미 아는 정보(구정보)로 열고, 문장 끝에 새로운 정보(신정보)를 놓으라는 건데요. 그러면 다음 문장은 또 그 새 정보를 받아서 시작하고, 그 끝에 또 새 정보를 놓고… 이렇게 정보가 손에 손잡고 이어지면서 글이 자연스럽게 흐르게 돼요. 읽다가 뚝뚝 끊기고 머리가 아픈 글은 십중팔구 이 순서가 뒤죽박죽이에요. 새 정보가 문장 맨 앞에 갑자기 툭 튀어나오니까 독자가 매번 '어? 이게 뭐지?' 하고 멈칫하게 되는 거죠.

업계 맥락: 글쓰기는 엔지니어의 핵심 역량

이게 그냥 '글 잘 쓰면 좋지' 수준의 이야기가 아니에요. 아마존은 회의에서 파워포인트를 금지하고 6페이지짜리 서술형 문서(narrative)를 다 같이 조용히 읽는 문화로 유명하고요, 구글을 비롯한 큰 회사들은 새 기능을 만들기 전에 디자인 문서(design doc)부터 씁니다. 왜냐면 글로 정리가 안 된 생각은 사실 아직 정리가 안 된 생각이거든요. 글쓰기는 결국 '생각하기'의 다른 이름이에요. 머릿속에서 그럴듯해 보였던 설계도 막상 글로 풀어 쓰는 순간 구멍이 훤히 드러나니까요.

한국 개발자에게 주는 시사점

당장 오늘부터 써먹을 수 있어요. PR 설명을 쓸 때 '이걸 처음 보는 동료가 배경을 알까?'를 한 번 점검해보세요(지식의 저주 체크). 문서나 회고를 쓸 때는 각 문단의 첫 문장을 앞 문단에서 이미 말한 내용과 연결해보세요(구정보-신정보). 요즘은 영어로 README나 기술 블로그를 쓸 일도 점점 많아지는데, 이 원리들은 언어를 가리지 않아요. 무엇보다 '나는 원래 글재주가 없어'라는 자기 검열을 내려놓는 게 출발점이에요. 재능이 아니라 연습으로 느는 기술이니까요.

마무리

글을 못 쓰는 게 아니라, 글쓰기의 규칙을 아직 안 배운 것뿐이에요. 여러분은 마지막으로 '내 글이 안 읽힌다'고 느꼈을 때, 그게 내용 탓이었나요 아니면 설명 순서나 빠진 맥락 탓이었나요? 본인만의 기술 글쓰기 노하우가 있다면 댓글로 공유해 주세요.


🔗 출처: Hacker News

이 뉴스가 유용했나요?

TTJ 코딩클래스 정규반

월급 외 수입,
코딩으로 만들 수 있습니다

17가지 수익 모델을 직접 실습하고, 1,300만원 상당의 자동화 도구와 소스코드를 받아가세요.

144+실전 강의
17개수익 모델
4.9수강생 평점
정규반 자세히 보기

"비전공 직장인인데 반년 만에 수익 파이프라인을 여러 개 만들었습니다"

실제 수강생 후기
  • 비전공자도 6개월이면 첫 수익
  • 20년 경력 개발자 직강
  • 자동화 프로그램 + 소스코드 제공

매일 AI·개발 뉴스를 받아보세요

주요 테크 뉴스를 매일 아침 이메일로 전해드립니다.

스팸 없이, 언제든 구독 취소 가능합니다.