본문 바로가기

728x90

테크니컬 라이팅

(353)
WTD 호주 2022 - 구글에서 많은 이들이 문서를 찾을 수 있게 하기 Braden Riggs는 2020년 5월 돌비에서 출시한 API 플랫폼 Dolby.io의 개발자 애드보케이트이면서 데이터 과학자로 일하고 있습니다. 영상 첫 번째 타이틀 상단에 돌비 로고가 새겨져 있어서 마치 돌비 사운드 기술을 사용한 것처럼 보입니다. 뭐 마이크는 좋은 것을 사용하는지 소리는 깔끔하긴 합니다. 개발자 애드보케이트 팀에서 일하면서 플랫폼을 개발자 커뮤니티에 알리려는 노력에 집중하며 커뮤니티와 많은 대화를 가졌는데요. 돌비라는 제품 특성 상 개발자들이 검색했을 때 원하는 결과를 얻기가 쉽지 않았다고 합니다. 그냥 "Dolby"라고 검색하기 때문이죠. 일반적으로 온라인 문서를 기획할 때 제품 페이지로 들어와서 문서 랜딩 페이지를 찾고 문서를 찾을 것이라 생각하지만 실제 사용자는 구글에서 검색..
2023년 1월 테크니컬 라이팅 이런 저런 소식 1월 2일 TCN 커뮤니티에서 진행하는 밋업 소식입니다. 2월 온라인으로 진행할 예정입니다. 저도 정확한 히스토리는 잘 모르지만 2009년 오프라인 세미나 이후 오랜만에 TCN에서 진행하는 행사가 되는 것 같네요. https://meetup.techcomnet.kr/2023-02 TCN meetup 2023.02 meetup.techcomnet.kr 1월 16일 AWS 윤석찬 테크 에반젤리스트가 Jeff Barr 부사장의 "Leadership Principles for AWS News Bloggers"이라는 글을 번역하고 자신의 경험을 더해 쓴 글입니다. https://channy.creation.net/blog/1758 블로거 리더쉽 원칙 :: Channy's Blog 차니 블로그(Channy Blog..
2022년 12월 테크니컬 라이팅 이런 저런 소식 12월 1일 한국형 무크(http://www.kmooc.kr/)에서 글로벌 무크 강의 수강을 지원합니다. 대상은 udemy와 Coursera이구요. 둘 다 신청할 수 있습니다(선착순입니다. 아마 예산이 정해져있고 예산 내에서 집행하는 듯합니다). 테크니컬 라이팅 강좌는 udemy에 좀 더 많이 준비되어 있죠. 아래 링크 안내를 따라 신청하면 SMS로 초대 링크가 날라오구요(저는 어제 저녁에 신청했는데 오늘 아침에 받았습니다. 바로 처리되는 건 아니고 뭔가 사람이 확인하는 듯합니다). 초대 링크 안내에 따라 기존 계정 연결 또는 가입하시면 이용할 수 있습니다. udemy가 요즘 이벤트 기간이라 90% 할인 막 이런 거 하는데 그래도 강의당 19,000원 정도이니 이런 기회를 이용하는 것도 좋을 듯합니다. ..
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에서는 문서 사용자 경험을 위해 사용자..

반응형