Latest — 2024년 10월 13일 학습(learning)이라는 인프라 나는 학습을 인프라의 관점에서 바라본다. 학습은 보호 받으며 자유로울 수 있다는 감각을 함께 경험할 수 있는 중요한 삶의 기반이다.
훌륭한 기술 문서, 좋은 테크니컬 라이팅이란 뭘까? 이제 테크니컬 라이터에게 '글을 쓰는 일'은 상대적으로 덜 중요하다고 느끼고 있다. 테크니컬 라이터에게 쓰는 일이 덜 중요하다니, 모순된 말 같지만 주요 사용자인 개발자가 정보를 얻고, 문서를 읽고 쓰는 경험이 바뀐다면 고민해야 하는 부분도 바뀔 수 있다.
기술 문서의 진화 단계 보통 우리는 '기술 문서'라고 하면 검색이 되는 정적 사이트를 떠올린다. 개발자가 코드를 짜다가 필요한 정보를 필요할 때 보고, 찾는 행동을 떠올린다. 하지만 일을 하다가 '다른 사이트'에 접근해서 '검색'을 하는 행위는 자연스럽지 않다. 사실상 업무 플로우를 깨는 것에 더 가깝다.
9년 만의 뉴욕 여행 단상 20대 때 다녀온 뉴욕과 30대가 되어 다녀온 뉴욕은 꽤 달랐다. 그때는 학생이었고 지금은 서울에서 일하는 사람이 된 지 오래라서 그럴까? 아니면 서울과 서울에서의 삶이 달라져서인지도 모르겠다.
[번역] API를 위한 최소한의 실행 가능한 문서(Minimum Viable Documentation) 최소 실행 가능한 문서 세트(Mininum Valuable Document)는 대다수의 개발자가 기꺼이 API를 채택할 수 있도록 필요한 최소한의 문서로, API가 시간을 낭비하기 때문에 좌절하거나 포기하지 않을 만큼의 최소한의 문서입니다.
[번역] Vercel에서의 개발자 경험 * 원문: Developer Experience at Vercel Vercel은 웹 개발자들이 더 쉽게 웹 사이트를 만들고 인터넷에 올릴 수 있도록 돕는 도구입니다. 개발자 커뮤니티에서 많은 인기를 얻고 있으며, 많은 개발자 및 기업이 Vercel을 웹 프로젝트를 배포하고 호스팅하기 위한 주요 플랫폼으로 선택하고 있습니다. 개발자는 생산성을 높이고 싶지만 도구의 복잡성으로 인해 속도가 느려지는 경우가 많습니다.