본문 바로가기

테크니컬 라이팅

 (441)
WTD 포틀랜드 2023 - 문서를 코드처럼 관리하는 건 항상 쉬운 건 아닙니다 이번 강연은 대충 어떤 이야기인지는 알겠는데 정리가 안되더라구요 ㅠㅠ 그래서 "YouTube & Article Summary powered by ChatGPT"라는 플러그인을 사용해 내용을 요약해 보았습니다. 무서운 세상이네요. 콘텐츠 관리 시스템(CMS)에서 문서를 코드처럼 관리하기로 전환하는 것이 쉽지 않다는 것을 공감합니다. 성공적으로 문서를 코드처럼 관리할 수 있게 하려면 그들을 응원하고 적절한 지침을 제공하는 것이 필요합니다. 문서를 코드처럼 관리하는 장점은 협업, 미리 보기, 통합 워크플로우 등을 이야기할 수 있습니다(물론 요즘 CMS 또는 매뉴얼 저작 도구에서도 이런 것들은 지원하고 있긴 합니다). 조직 내에서 문서를 코드처럼 관리하기로 전환하기 위해 적합성을 평가하고 어느 정도의 비용이 들..
WTD 포틀랜드 2023 - 사용자 피드백을 가지고 문서 개선하기 Ryan Young은 스트라이프 테크니컬 에디터입니다. 스트라이트에서 사용자 피드백을 가지고 어떻게 문서화를 개선했는지 설명합니다. 스트라이프 문서는 사용자가 피드백을 제공할 수 있는 기능을 지원합니다. 이런 피드백을 기반으로 사용자가 작업을 수행하기 위해 필요한 다양한 기능을 추가하고 있습니다. 그럼에도 계속 사용자의 불만은 늘어갔습니다. 그래서 피드백을 천천히 들여다보기 시작했습니다. 그중 하나가 "너무 많은 옵션(Too many options)"을 제공한다는 것이었습니다(문서 시스템의 기능을 이야기하는 건 아니고 제품 자체에서 다양한 옵션을 제공하는데 그런 옵션 설명이 흩어져있다는 것입니다). 그래서 사용자가 필요한 작업을 수행하기 위해 살펴봐야 하는 문서의 내용이 한 곳에 있지 않고 여러 곳에 흩..
2023년 6월 테크니컬 라이팅 이런 저런 소식 6월 14일 9월 10일부터 12일까지 진행되는 WTD ATLANTIC 2023 콘퍼런스 발표자가 확정됐습니다. 9월인데 좀 빠르지 않나 싶은데 발표 준비하는 분들도 시간이 필요하니 그런 듯합니다. ATLANTIC 행사는 오프라인으로는 진행하지 않고 온라인으로만 진행합니다. 온라인이지만 콘퍼런스 참석을 위해서는 참가비를 내고 신청해야 하며 세션 영상은 행사 종료 후 1주일 이후에 유튜브를 통해 공유됩니다. https://www.writethedocs.org/conf/atlantic/2023/news/announcing-speakers/ 6월 16일 데브시스터즈 남정현 님이 지난 8일 CJ올리브네트웍스에서 진행한 강의 사전 질문, 답변을 정리한 문서를 공개했습니다. 강의 때 못다 한 답변을 담은 것이라 부..
2023년 5월 테크니컬 라이팅 이런 저런 소식 5월 7일 WTD 포틀랜드 2023 행사가 7일부터 9일까지 진행됩니다. 오랜만에 오프라인, 온라인 동시에 진행되는 행사입니다. WTD 슬랙에 행사 사진들도 슬슬 올라오고 있구요. 각 세션 영상은 행사가 끝나면 공유될 예정입니다. 어떤 분위기일지 궁금하네요. https://www.writethedocs.org/conf/portland/2023/ Home | Write the docs Portland 2023 Welcome to Write the Docs Portland 2023- May 01, 2023, Write the Docs
WTD 호주 2022 요약 - 라이트닝 토크 모음 Cameron Shorter - My Open Source Docs Addiction https://youtu.be/S-6NxPUorgU 오픈소스에 참여하면 얻을 수 있는 것들 - 영향력을 넓힐 수 있습니다. - 아무도 여러분을 방해하지 않습니다. 원하는 걸 다 해볼 수 있죠. - 커뮤니티에 참여하면서 다양한 경험을 할 수 있습니다. 뭐 물론 오픈소스 커뮤니티라고 해서 다 깔끔한 건 아닙니다. 심지어는 정치적인 다툼도 있구요. 뭔가 발표가 어설퍼보이지만 이 분은 구글 테크니컬 라이터이면서 제품 관리자입니다. 구글에는 2020년 합류했고 그 이전에는 다양한 기업에서 엔지니어, 테크니컬 라이터로 일했습니다. 1987년에 학위 과정을 시작했으니 대략 50대 중반이시겠네요. Gaurav Nelson - Unlo..
WTD 호주 2022 - PLG 전략과 기술 문서 Alex Fiedler는 Torq라는 사이버 보안 플랫폼 기업에서 지식 경험 부문을 담당하고 있습니다. PLG는 Product-Led Growth의 약자라고 합니다. 우리말로 번역하면 제품주도성장이라는 의미라고 합니다. Wes Bush의 책 "Product-Led Growth: How to Build a Product That Sells Itself"에서 시작된 표현이라고 하네요. 2019년에 나온 책인데 이 책이 번역되지 않은 것은 좀 신기하네요. https://productled.com/book 에서 온라인으로 내용을 볼 수는 있습니다. PLG 전략이 새로운 것은 아니지만 최근 테크 기업에서 많은 관심을 받고 있고 그 영향력을 넓혀가고 있습니다. 지식 경험이라는 표현은 좀 낯설 수 있는데요. 지식은 ..
2023년 4월 테크니컬 라이팅 이런 저런 소식 4월 3일 "Docs for Developers 기술 문서 작성 완벽 가이드"가 4월 10일 출간 예정이라고 합니다. 부록으로 "국내 유명 테크니컬 라이터 11인의 인터뷰가 수록"됐다고 하네요. 원서 제목은 "Docs for Developers: An Engineer’s Field Guide to Technical Writing"입니다. https://www.hanbit.co.kr/store/books/look.php?p_code=B8810771470 Docs for Developers 기술 문서 작성 완벽 가이드 소프트웨어 개발자를 안내하는 테크니컬 라이팅을 위한 실무 노트 우아한형제들, 카카오, AWS, LINE Plus, 쿠팡, NHN, 데브시스터즈, 넷마블 등 국내 테크니컬 라이터 11인 인터뷰 ..
2023년 3월 테크니컬 라이팅 이런 저런 소식 3월 7일 reddit에 "what is 'cool' about being a technical writer?"라는 질문이 올라왔습니다. 뭐 좋은 답변도 많은데 가슴 아픈 이야기도 많네요. - The fact that I've been doing this for three years and still nobody from my family and most of my friends don't understand what I'm doing. - My mom thought I've been working at a call center for the past 8 years, regardless of all my job and career changes I've told her about. - Barely any..
반응형

티스토리툴바