본문 바로가기

728x90

테크니컬 라이팅

(310)
2022년 11월 테크니컬 라이팅 이런 저런 소식 11월 7일 WTD 2023년 컨퍼런스 일정이 공개됐습니다. 포틀랜드 행사는 오프라인으로 5월 7일부터 9일까지 열리고 WriteTheDocs 애틀랜틱이라는 이름으로 9월 10일부터 12일까지 온라인 이벤트가 진행됩니다. WriteTheDocs 애틀랜틱 행사는 미국 동부 기준으로 오전에 시작한다고 합니다. 한국과는 대략 14시간 정도 차이네요. 포틀랜드까지 오기 어려운 미국 동부 지역과 유럽 등 시간대를 고려한 듯합니다. https://www.writethedocs.org/blog/2023-conference-announcements/ 중앙대학교 비전공자 코딩 커뮤니티 COSADAMA에서 11월 2일 '서비스의 기술 문서를 책임지는 테크니컬 라이터'라는 주제로 카카오 엔터프라이즈 인턴 이해영 님이 발표한..
2022년 10월 테크니컬 라이팅 이런 저런 소식 10월 4일 bytebase라는 스타트업에서 이용하는 SaaS 서비스 중 가장 많은 비용을 지출하는 것이 grammarly 라고 합니다. 월 200달러를 지출하는데 연간 플랜으로 40% 할인받고 대략 13-14명이 사용하는 듯합니다. https://www.grammarly.com/upgrade/business/try https://www.bytebase.com/jobs 에서 엔지니어링 인턴을 뽑고 있는데 선발 과정의 마지막 단계에 기술 작문 단계가 있습니다. 뭔가 글쓰기에 진심인 회사가 아닌가 싶네요. https://news.hada.io/topic?id=7534 10월 7일 지난주 목요일(9월 29일) 진행했던 라인 밋업 영상입니다. 3개의 영상이 차례로 공개됐습니다. https://youtu.be/9..
WTD 프라하 2022 요약 - 라이트닝 토크 모음 [Lightning Talk] Abi Sutherland - Can we NOT do docs at the eleventh hour? Mmmmmaybe. TomTom의 정보 아키텍트를 12년째 담당하고 있습니다. 작년 WTD 프라하 라이트닝 토크에서는 오래된 가이드북에 대한 이야기를 공유해주었습니다. 개발 프로세스 내에서 문서화 작업은 계획 단계에서 산정되고 계획되어야 하며 별도의 티켓으로 처리되고 우선순위가 명확하게 지정되어야 제대로 일할 수 있다는 겁니다. 그렇지 않으면 문서가 누락될 수도 있고 막판에 일이 몰릴 수도 있죠. 작은 화이트보드를 활용해서 발표하는데 아마도 라이트닝 토크에 주어진 시간은 초과한 것 같지만 뭔가 인상적이네요. * eleventh hour는 '마감이 임박한 시간'이라는 의미라..
WTD 프라하 2022 - 누구나 일하는 방식은 다를 수 있다 Tyler는 27살에 ADHD 진단을 받았다고 합니다. 지금은 GitHub에서 테크니컬 라이터로 일하고 있습니다. 2008년에 고등학교를 졸업하고 2010년부터 일을 시작한 것 같네요. 시작은 서비스 지원 쪽에서 시작해서 GitHub으로 오면서 작년 4월부터 테크니컬 라이터로 일하고 있습니다. 다른 상황도 마찬가지지만 혹 이 강연이 ADHD 진단을 받은 모든 이들에게 해당하는 것은 아니고 개인적인 경험을 바탕으로 한다고 전제한 후에 진행합니다. 27살에 ADHD 진단을 받은 것은 상당히 늦은 편인데요. 그 이전에 3차례 양극성 장애와 우울증으로 잘못된 판정을 받았고 27살이 되어서야 자신의 불안과 우울증이 ADHD 때문이라는 것을 알게 되었다고 합니다. 세션 제목은 Creative Process for ..
WTD 프라하 2022 - Stripe는 왜 Marodoc을 만들었나요? Ryan은 Stripe 문서팀의 엔지니어입니다. 국내에도 라인이나 토스 페이먼츠 같은 경우 문서팀에 소속된 엔지니어가 있죠. 성장하는 조직에서는 수시로 제품에 맞게 문서화 워크플로를 변경해야 할 수 있는데 이런 경우 전담 엔지니어가 있으면 큰 도움이 됩니다. Ryan의 경우는 2016년에 테크니컬 라이터로 합류했고 지금은 문서팀과 엔지니어 지원을 조정하는 역할을 하고 있는 듯합니다. 흔히 문서를 이야기할 때 사용자 경험을 많이 강조하지만 조직이나 제품의 특성에 따라 개발자 또는 테크니컬 라이터(기여자)의 경험 역시 중요합니다. 문서 플랫폼이 필요한 이유는 단지 문서가 사용자에게 전달되는 순간뿐 아니라 문서가 만들어지는 워크플로 자체가 중요하기 때문입니다. Stripe에서는 문서 사용자 경험을 위해 사용자..
WTD 프라하 2022 - 아프리카의 테크니컬 라이팅 아프리카라고 해서 크게 다른 건 없습니다. 다만 일단 문서 기본 언어를 영어로 사용하고 있고 대륙 전체를 커버할 수 있다는 점에서 다르지 않을까 싶네요. 아프리카 내 커뮤니티에서 문서화 관련 조사를 진행하고 이에 대한 결과를 공유합니다. 2명이 세션을 진행하는데 Mustapha는 Paga라는 핀테크 스타트업의 Developer Engagement 팀 리드를 담당하고 있습니다. Paga에서 제공하는 서비스는 1800만 정도가 사용하고 있다고 합니다. 그리고 Benny는 데이터 분석가이면서 테크니컬 라이터 업무를 담당하고 있습니다. Hit Subscribe와 Sematext에서 계약직으로 일한다고 하는데 어떤 식으로 계약을 한 것인지는 모르겠네요. 먼저 아프리카의 개발자에 대해 살펴봅니다. 구글과 엑센츄어에..
WTD 프라하 2022 - 커뮤니티에서 번역으로 기여하기 MetaDocencia는 라틴 아메리카의 오픈 소스, 오픈 사이언스 지원 기관입니다. Docencia는 스페인어로 교육이라는 의미라고 하네요. Melissa는 Infrastructure and Impact Measurement Coordinator를 담당하고 있다고 합니다. 사회 문제를 해결하기 위한 기업에서 지출된 비용에 대한 효과, 사회적 수익을 측정하는 것을 임팩트 측정이라고 합니다. 뭐 그런 효과를 측정하고 기반 시설을 조정하는 역할인 듯합니다. 이번에 다루는 건 MetaDocencia는 아니고 The Turing Way 라는 프로젝트에 대한 이야기입니다. GitHub에서는 재현 가능한 데이터 과학을 안내하는 가이드라고 소개하고 있습니다. https://github.com/alan-turing-i..
라인 밋업 정리(Q&A) - 테크니컬 라이터 전망이 어떤가요? 제목은 낚시고 그냥 Q&A입니다. 사전 접수 시 받은 질문과 현장 댓글 질문을 포함해 3명의 테크니컬 라이터가 답변을 하는 형식입니다. 나름 정리를 했는데 실제 답변 내용을 잘못 이해하고 작성한 내용이 있을 수 있으니 영상을 꼭 참고하세요. 먼저 사전에 받은 5가지 질문에 대한 Q&A (1) 앞으로 테크니컬 라이터의 전망은 어떤가요? 10년 이상 경력이 40.9%, 5년~10년 사이가 18.2% (그럼 5년 차 이상 테크니컬 라이터가 답변자의 약 60% 정도가 된다는 이야기인데 어떻게 보면 테크니컬 라이터가 오래 할 수 있는 직종인가 싶기도 하지만 또 어떻게 보면 한 번 이 세계에 발을 디디면 빠져나가기 힘든 곳이기도 합니다. 전망이라는 관점에서 본다면 5년 이상 경력을 가진 분들에게 조직의 성장과 테크..

반응형