# 프로그래머의 글쓰기

2025년 5월호 코드스냅 뉴스레터를 소개합니다.

웹 개발 번역 매거진 코드스냅은 매월 다른 주제의 아티클을 선정하여 한국어로 전달해 드립니다. 5월호 뉴스레터는 **&lt;프로그래머의 글쓰기: 코드 작성을 넘어 기술적인 글 작성하기&gt;**라는 주제로 팀원들이 세 편의 번역을 준비했습니다.

개발자에게 코드 작성은 핵심 역량이지만, 코드를 설명하고 공유하는 능력 또한 그에 못지않게 중요합니다. 기술 블로그, 사내 문서, 외부 API 가이드 등 개발자가 글을 써야 할 순간은 생각보다 많습니다. 좋은 글은 협업을 원활하게 하고, 지식을 전파하며, 오해를 줄이는 힘을 갖고 있죠.

이번 뉴스레터에서는 사내 문서와 외부 문서 작성의 차이를 짚은 글부터, 만화로 기술 개념을 설명하는 참신한 방법, 그리고 더 많은 사람을 배려하는 글쓰기를 소개합니다. “개발자다움”을 글로 표현하는 다양한 방식이 궁금하셨다면 이번 호를 놓치지 마세요.

코드를 넘어 더 잘 전달하는 방법을 고민하는 여러분께 이번 뉴스레터가 작은 실마리가 되어주길 바랍니다. 📝🚀

---

## 5월호 뉴스레터 미리보기

### 내부 문서와 외부 문서 작성은 어떻게 다른가

원저: [**Sarah Maddox**](https://x.com/sarahmaddox) | 번역: @[Hyunji Seok](@somebodylovesusall)  
발행일: 2025년 5월 10일

기록의 가장 중요한 기능은 무엇일까요? 결국 문서는 누군가에게 어떤 내용을 명확히 전달하기 위하여 작성하는 것입니다. 그 누군가는 조직 구성원일수도, 외부 사용자일수도, 미래의 자신이 될 수도 있는 것이죠. 저자는 독자의 입장에서 문서를 작성하라고 강조합니다. 특히 이 글에서는 조직 내부 독자를 위한 문서 작성과 외부 독자를 위한 문서 작성이 어떻게 다른지 살펴봅니다.

### 기술적 개념을 만화로 설명하는 방법

원저: [**Julia Evans**](https://jvns.ca/teach-tech-with-cartoons/) | 번역: @[Ahra Yi](@ooz34)  
발행일: 2025년 5월 20일

개발자로서 ‘글’을 쓰는 방식은 무궁무진합니다. 애정하는 기술 개념을 만화로 풀어낸 줄리아 에반스의 방식은 유쾌하고 명쾌합니다. 새로운 형식으로 나만의 브랜딩을 시작해 보고 싶은 분들께 이 글을 추천합니다.

### 웹 접근성을 위한 글쓰기

원저: [**Kevin White**](https://www.w3.org/People/kevin/)**,** [**Shadi Abou-Zahra**](https://www.w3.org/People/shadi/)**,** [**Shawn Lawton Henry**](https://www.w3.org/People/Shawn/) | 번역: @[윤정민](@cruelladevil)  
발행일: 2025년 5월 30일

UX 라이팅에 대해 관심을 갖고 글을 찾아보던 중, 읽기 좋은 문장을 넘어서 접근성까지 고려한 글쓰기에 대해 다룬 글을 보게 되었습니다. “웹 접근성을 위한 글쓰기”는 우리가 쓰는 표현 방식이 얼마나 많은 사용자 경험에 영향을 줄 수 있는지를 잘 보여줍니다.
