Sign in Subscribe

Jennybe

A technical writer @Seoul

📍 Seoul

우리를 끈기 있게 만드는 것

끈기는 내가 중요하다고 생각하는 문제를 탐구하는 것에서 시작된다.

훌륭한 기술 문서, 좋은 테크니컬 라이팅이란 뭘까?

이제 테크니컬 라이터에게 '글을 쓰는 일'은 상대적으로 덜 중요하다고 느끼고 있다. 테크니컬 라이터에게 쓰는 일이 덜 중요하다니, 모순된 말 같지만 주요 사용자인 개발자가 정보를 얻고, 문서를 읽고 쓰는 경험이 바뀐다면 고민해야 하는 부분도 바뀔 수 있다.

기술 문서의 진화 단계

보통 우리는 '기술 문서'라고 하면 검색이 되는 정적 사이트를 떠올린다. 개발자가 코드를 짜다가 필요한 정보를 필요할 때 보고, 찾는 행동을 떠올린다. 하지만 일을 하다가 '다른 사이트'에 접근해서 '검색'을 하는 행위는 자연스럽지 않다. 사실상 업무 플로우를 깨는 것에 더 가깝다.

세상에서 글쓰기에 가장 관심 많은 스타트업

"글을 쓰는 사람이라면 여기를 'home'으로 느낄 거예요."

9년 만의 뉴욕 여행 단상

20대 때 다녀온 뉴욕과 30대가 되어 다녀온 뉴욕은 꽤 달랐다. 그때는 학생이었고 지금은 서울에서 일하는 사람이 된 지 오래라서 그럴까? 아니면 서울과 서울에서의 삶이 달라져서인지도 모르겠다.

[번역] API를 위한 최소한의 실행 가능한 문서(Minimum Viable Documentation)

최소 실행 가능한 문서 세트(Mininum Valuable Document)는 대다수의 개발자가 기꺼이 API를 채택할 수 있도록 필요한 최소한의 문서로, API가 시간을 낭비하기 때문에 좌절하거나 포기하지 않을 만큼의 최소한의 문서입니다.

[번역] 훌륭한 개발자 경험을 만드는 것은 무엇일까요?

'훌륭한 개발자 경험'에 대한 Vercel VP of Product의 생각

[번역] Vercel에서의 개발자 경험

* 원문: Developer Experience at Vercel Vercel은 웹 개발자들이 더 쉽게 웹 사이트를 만들고 인터넷에 올릴 수 있도록 돕는 도구입니다. 개발자 커뮤니티에서 많은 인기를 얻고 있으며, 많은 개발자 및 기업이 Vercel을 웹 프로젝트를 배포하고 호스팅하기 위한 주요 플랫폼으로 선택하고 있습니다. 개발자는 생산성을 높이고 싶지만 도구의 복잡성으로 인해 속도가 느려지는 경우가 많습니다.

[번역] 데모 프론트엔드: API를 테스트하고 탐색할 수 있는 프론트엔드 애플리케이션

"데모 프론트엔드는 일종의 설명서 역할을 하여 API 사용자에게 API를 어떻게 사용해야 하는지 안내하거나, 완전한 구현을 위한 예제로 사용할 수 있습니다."

[번역] 덜 검색하고, 더 많이 탐색하기

검색은 해결에 좋고 탐색은 아는 범위 바깥을 발견하기 좋습니다.