개발자는 글을 못 쓴다고요?

문서는 실력이고, 글은 또 하나의 코드입니다

 

개발자는 오늘도 글을 씁니다. 커밋 메시지부터 리드미, 릴리스 노트, 기술 블로그까지 일의 많은 순간에 글이 필요합니다. 이 책은 그런 글을 더 잘 쓰고 싶은 개발자를 위한 실전 가이드입니다. 주석, 예제 코드, 시작하기 문서처럼 자주 마주치는 글쓰기부터 정확하고 간결한 기술 문서 작성법, 이메일과 메시지, ChatGPT 활용 팁까지 실무에 꼭 맞는 내용으로 구성했습니다. 글이 쌓이면 문서가 되고 문서는 곧 실력이 됩니다. 글 앞에서 자주 멈칫하는 개발자에게 이 책이 글쓰기 실력을 키우는 든든한 첫걸음이 되어줄 것입니다.

 

도서구매 사이트(가나다순)

[교보문고]  [도서11번가]  [알라딘]  [예스이십사]  [쿠팡]

 

전자책 구매 사이트(가나다순)

[교보문고] [구글북스] [리디북스] [알라딘] [예스이십사]

 

출판사 제이펍
저작권사 제이펍
원서명 (없음)
도서명 개발자는 글을 못 쓴다고요?
부제 커밋 메시지부터 리드미, 릴리스 노트, 장애 보고서, 기술 블로그, ChatGPT 활용까지 개발자를 위한 글쓰기 실전 가이드
지은이 전정은, 황수정
옮긴이 (없음)
감수자 (없음)
시리즈 (없음)
출판일 2025. 11. 20
페이지 428쪽
판 형 크라운판변형(170*225*20.4)
제 본 무선(soft cover)
정 가 28,000원
ISBN 979-11-94587-63-7 13000
키워드 함수명, 오류 메시지, API 주석, 템플릿, 예시 코드, 시작하기 문서, 체인지 로그, 다이어그램, 이메일, AI 도구
분 야 개발방법론 / 글쓰기

 

관련 사이트
■ (없음)

 

관련 시리즈

■ (없음)

 

관련 포스트

■ 2025.11.11 - [출간 전 책 소식] - 개발자: "글을 잘 쓰고 싶어요"

 

관련 도서

■ 실무에 바로 쓰는 일잘러의 챗GPT 프롬프트 74가지

 

관련 파일 다운로드

■ (없음)

 

강의 보조 자료(교재로 채택하신 분들은 https://jpub.tistory.com/notice/1076을 통해 다음 자료를 요청하실 수 있습니다.)
■ 본문의 그림과 표

 

미리보기(앞부속, 본문 일부)

 

정오표 페이지
■ (등록되는 대로 링크를 걸겠습니다.)

 

도서구매 사이트(가나다순)

[교보문고]  [도서11번가]  [알라딘]  [예스이십사]  [쿠팡]

 

전자책 구매 사이트(가나다순)

[교보문고] [구글북스] [리디북스] [알라딘] [예스이십사]

 

도서 소개

코드만큼 중요한 문서, 이제는 쓰는 법도 알려드립니다

 

“개발자는 글을 못 쓴다?”

 

개발자들이 정말 글을 못 쓴다면 그 수많은 기술 문서와 블로그 글은 누가 쓴 걸까요? 모두 개발자가 쓴 글입니다. 매일 커밋 메시지를 쓰고, 변수명을 짓고, 리드미를 작성하고, 슬랙에 답하며 끊임없이 글을 씁니다. 그럼에도 많은 개발자가 글쓰기를 어려워합니다. ‘무엇을’, ‘어떻게’ 써야 할지 배운 적이 없기 때문입니다.

 

이 책은 그 막막함에 실전적인 답을 줍니다. 커밋 메시지를 한 줄로 깔끔하게 쓰는 법, 변수명과 함수명을 더 명확하게 짓는 원칙, 오류 메시지와 주석을 사용자 입장에서 다듬는 방법, 리드미와 시작하기 문서를 쉽게 구성하는 법, 기술 블로그로 설명력을 높이는 팁까지 실무에 바로 쓸 수 있는 글쓰기 전략을 실제 사례와 함께 설명합니다. 여기에 이메일과 슬랙 메시지처럼 협업에 꼭 필요한 글쓰기부터 ChatGPT에게 제대로 묻고 설명하는 프롬프트 작성까지 지금의 개발자에게 꼭 필요한 기술적 글쓰기를 폭넓고 깊이 있게 다룹니다.

 

개발자는 글을 못 쓴다? 아니요. 이 책과 함께라면 개발자도 글을 잘 쓸 수 있습니다.

 

주요 내용

• 커밋 메시지, 오류 메시지, 주석을 명확하게 쓰는 법
• 변수명과 함수명을 잘 짓기 위한 작명 원칙
• 리드미, 릴리스 노트, 시작하기 문서의 실전 구성법
• 기술 블로그와 예제 코드로 설명력을 높이는 방법
• 정확하고 간결한 기술 문서를 쓰는 세 가지 기법
• 이메일, 메시지 잘 쓰는 법과 ChatGPT 활용 팁

 

지은이 소개

전정은

LINE PLUS에서 기술 문서를 효율적으로 작성하고 관리하는 방법을 추구하는 문서 엔지니어다. 회사에서는 기술 문서를 쓰는 한편으로 더 나은 글쓰기 도구를 만들고 있으며, 회사 밖에서는 블로그와 강연을 통해 글쓰기 경험을 공유하고 있다. 고전적인 방식에 머무르기보다 새로운 기술을 접목해 문서의 품질과 가치를 높이는 일에 즐거움을 느낀다. AI가 글쓰기를 대체할 것이라는 우려 속에서도 ‘변화에 적응하며 기회를 찾으면 된다’고 믿는 낙관론자이기도 하다. 소설가를 꿈꾸던 감수성과 컴퓨터에 빠져 공학을 배운 논리력을 발휘해, 재미있고 논리적인 글쓰기의 세계를 탐험하고 있다.

 

황수정

LINE PLUS에서 글 읽고, 글 쓰고, 글 더하고, 글 빼고, 글 다듬고, 글 심고, 글 뽑고, 글 빚고, 글 굽고, 글 꿰어서 개발자와 개발자를 잇는 일을 하고 있다.

 

차례

추천의 글 12

베타리더 후기 18

여는 글 20

 

PART I 개발자는 정말 글을 못 쓸까?

1 개발자는 코드로 소통한다? 27

2 반복, 또 반복 29

3 글에는 목적이 있다 31

4 번역서 참고는 그만 34

 

PART II 글을 잘 쓰는 개발자는 코드부터 다르다

5 커밋 메시지 작성하기 41

커밋 메시지를 잘 써야 하는 이유 43

커밋을 설계하세요 46

[쉬어가기] 커밋 메시지 해부학 47

커밋 메시지 제목 쓰기 49

커밋 메시지 본문 쓰기 64

커밋 메시지 작성해보기 68

커밋 메시지 맛집 70

 

6 개발자는 작명가 72

함수에 걸맞은 이름 짓기 74

함수 이름 짓기 연습 84

 

7 오류 메시지 쓰기 100

오류 메시지 구성 요소 101

오류 메시지를 봤는데 무슨 말인지 모르겠다 103

어떻게 해결해야 하는지 모르겠다 107

오류 메시지에 있는 안내대로 했는데 해결이 안 된다 109

해결 방법을 어디서 찾아야 하는지 모르겠다 109

[쉬어가기] 금과 은 나 없어도 내게 있는 것 네게 주니 110

 

8 API 주석 111

API 주석 형식 116

API 설명 기본 규칙 118

실전 연습 124

설명문 형식 정하기 128

[쉬어가기] API 설명은 영어여야만 할까요? 130

OpenAPI 명세로 쓰기 131

도구를 너무 믿지 말자 133

[쉬어가기] 미래의 나를 위해서라도 꼭 쓰세요! 134

 

PART III 개발자의 글은 곧 PR이다

9 리드미 139

나를 읽어주세요 142

리드미에 써야 할 정보는? 143

실전 리드미 작성 148

[쉬어가기] ‘모두가 아는 정보’ 판단법 153

이왕이면 다홍치마 154

템플릿, 널 위해 준비했어 157

 

10 예시 코드 159

예시 코드가 있어야 할 곳 160

소스 코드 말고 예시를 161

소스 코드를 예시로 만드는 주문 168

[쉬어가기] 예시 코드에서 내부 정보 감추기 172

샘플 프로그램 173

[쉬어가기] cURL 예시도 REST API 예시 코드일까요? 175

작동하지 않으면 코드가 아니다 177

 

11 장애 보고서 179

[쉬어가기] 서비스가 멈추는 순간, 우리가 겪는 불편함 181

장애 보고서란? 181

장애 보고서엔 무엇을 쓰나요? 183

장애 보고서는 누가 쓰나요? 192

장애 보고서는 언제 쓰나요? 193

장애 보고서는 어디에 쓰나요? 195

 

12 릴리스 노트 206

릴리스 노트? 체인지 로그? 207

[쉬어가기] 반박 시 당신 말씀이 맞습니다만, 저도 맞을 수 있지 않을까요? 210

릴리스 노트를 알아봅시다 211

[쉬어가기] 끝날 때까진 끝난 것이 아니다! deprecated는 ‘아직’이에요 213

[쉬어가기] 릴리스 노트가 길어지면 어쩌죠? 221

[쉬어가기] 문서도 릴리스 노트를 써야 할까요? 228

체인지 로그를 알아봅시다 229

[쉬어가기] 해당하는 정보가 없을 땐 없다고 명시하세요 234

 

13 시작하기 문서 236

시작하기의 도입부: 가입과 설치 238

시작하기의 핵심: 기본 기능 수행 240

시작하기의 마무리 243

문제점 찾기 연습 246

 

14 기술 블로그 253

무엇을 얻고 싶은가요? 254

블로그, 기본 틀 257

블로그, 어떤 글을 쓸까요? 268

[쉬어가기] 글로 영업해보세요 270

블로그, 쓸 때 생각해볼 것 276

[쉬어가기] 소화할 수 있는 글쓰기 277

블로그, 시작해봅시다 283

블로그, 어렵죠? 289

 

PART IV 기술 글쓰기에는 기법이 있다

15 정확성 295

정확한 용어 사용하기 298

[쉬어가기] 실무에서 쓰는 표현 기술 문서에 알맞게 포장하기 305

명령문과 평서문 307

명령문과 평서문 둘 다 표현할 수 있을 때는? 316

[쉬어가기] 쉴 수 있을 때 쉬어야 하니 쉬세요! 317

최신 정보 반영하기 317

 

16 간결성 326

두괄식으로 쓰기 328

목록과 표 335

[쉬어가기] 점 목록만으로 쓴 문서는 정말 읽기 쉬울까요? 341

[쉬어가기] 귀찮지만 포기할 수 없는 셀 병합 345

다이어그램 348

 

17 완결성 363

도입부 쓰기 364

[쉬어가기] 용어 설명은 짧은 팝업으로 출력해보세요 371

[쉬어가기] 형식과 기법보다는 내용과 목적이 중요합니다 374

일단 쓰고 지우기 374

우리말로 글쓰기 387

[쉬어가기] 지금 무슨 말을 하고 있는지 아나요? 389

[쉬어가기] 우리말, 우리글로도 할 수 있어요 396

 

APPENDIX 메시지도, AI 도구도 글쓰기에서 시작된다

A 이메일이나 메시지 쓰기 403

이메일 또는 남겨둘 메시지 쓰기 404

지시하고 응답하기 406

문제 상황 보고하기 408

 

B ChatGPT 활용하기 411

‘네가 해줘’ 말고 ‘도와줘’ 411

API 주석 쓰기 413

규칙 검사하기 419

 

도판 출처 426

 

제이펍 소식 더 보기(제이펍의 소통 채널에서 더욱 다양한 소식을 확인하세요!)

블로그  유튜브  인스타그램  트위터  페이스북