본문 바로가기

테크니컬 라이팅

(370)
2025년 5월 테크니컬 라이팅 이런 저런 소식 5월 8일Write the Docs Portland 2025 행사가 잘 마무리되었나 봅니다. 현장 분위기를 살짝 느낄 수 있는 사진 앨범이 공유되었습니다. 아마 5월 말 정도에 발표 영상도 공유될 것 같네요.https://www.flickr.com/photos/writethedocs/albums/72177720325861452 10월에는 베를린, 11월에는 오스트레일리아 컨퍼런스가 준비되고 있습니다.https://www.writethedocs.org/conf/berlin/2025/news/welcome/https://www.writethedocs.org/conf/australia/2025/news/welcome/ 5월 9일State of Docs Report 2025 GitBook에서 테크니컬 라이터 ..
2025년 4월 테크니컬 라이팅 이런 저런 소식 4월 1일Google, Gemini 2.5 Pro Canvas 무료로 공개 (x.com/sundarpichai)Now everyone can code + create with Gemini 2.5 Pro using Canvas in the @GeminiApp – our most advanced model + SOTA across many benchmarks. Give it a try!https://x.com/sundarpichai/status/1906874604683137285정확하게는 무료로 체험해 볼 수 있다 정도입니다. 문서 또는 코드 하나 생성하면 한도에 도달해 버립니다. 실무에 무료 버전을 활용할 전도는 아니네요. 그래도 실제 동작하는(물론 몇 가지 문법에 대한 시뮬레이션 정도로) 한국어 맞춤법..
WTD 호주 2025(Virtual) - AI 도구를 사용해 릴리스 노트 자동으로 생성하기 호주 오프라인 컨퍼런스는 가을 정도에 개최를 하는데 Virtual 이벤트라고 영상이 올라왔더라구요. 찾아보니, 이전에도 간혹 진행했던 행사인 모양입니다. 이번에는 idratherbewriting.com 블로그 운영자로 잘 알려진 Tom Johnson의 발표입니다. 블로그를 구독하거나 간혹 보시는 분들은 최근 AI 관련해서 올라오는 그의 글을 이미 보았을 겁니다. 참고발표 슬라이드와 원본 블로그, 관련 영상을 참고할 수 있습니다.슬라이드 https://idbwrtng.com/releasenoteswithai(블로그) Using file diffs for better release notes in reference docs https://idratherbewriting.com/ai/prompt-enginee..
WTD 호주 2024 - 라이트닝 토크 모음 Michael Park - Interviewing tips and tricks Canonical은 원격 근무를 기본으로 하고 있어서 전 세계적으로 채용을 진행합니다. 때문에 채용 프로세스가 상당히 엄격하다고 하네요. (면접 후기가 궁금하신 분들은 아래 링크를 참고하세요). Canonical 채용 면접 후기 https://brunch.co.kr/@youngstone89/309아마 직군에 따라 인터뷰에서 중요하게 여기는 부분이 다를텐데 Michael Park는 5W1H(Who, What, Where, When, Why, How)를 중심으로 인터뷰를 진행하고 그중에서도 Why와 How에 초점을 맞춘다고 합니다. - Why are you a technical writer - Why do you want to b..
WTD 호주 2024 - AI로 만든 짧은 동영상으로 정보 제공하기 기존에 만들었던 영상은 1시간 분량인데, 통계를 보면 30분 이후에 50% 이상 이탈하는 것을 확인할 수 있습니다. 기대했던 것보다 낮은 수치라 70% 이상 참여할 수 있게 하고 싶었습니다. 1분 내외의 영상을 만들고 나서 85% 이상이 필요한 영상을 찾아서 확인하고 있다고 합니다. 실제 영상 목록을 보면 1분에서 6분 정도로 구성하고 있습니다. 명확하게 영상의 요약을 제시하고 사용자가 필요한 영상만 선택해서 볼 수 있게 합니다. 때문에 1시간짜리 영상을 보는 것과는 결과가 명확히 달라지겠죠. https://knowledge.eptura.com/Asset/Training_Videos영상을 만들 때 AI 도구(synthesia)를 사용해 각 제품별로 아바타를 따로 생성합니다. 그렇게 하면 사용자는 자신이 ..
2025년 3월 테크니컬 라이팅 이런 저런 소식 3월 4일도큐멘트 엔지니어국내 기업에서 도큐멘트 엔지니어를 별도 직군으로 모집하는 것은 처음 본 것 같습니다(라인에서 모집한 적이 있긴 하지만, 라인은 국내 기업이라고 해도 되나 싶어서). 물론 제가 못보고 지나간 것일 수도 있지만.https://www.wanted.co.kr/wd/267946 카테노이드에서는 테크니컬 라이터를 채용하고 문서 서비스를 제공하고 있습니다. TCN 2023년 2월 밋업에서 카테노이드 테크니컬 라이터로 일하는 분이 발표를 하신 적도 있습니다.2023.02.17 - [테크니컬 라이팅] - TCN 2023년 2월 밋업 정리 테크니컬 라이터와 도큐멘트 엔지니어 공지글을 비교해 보면 기업에서 어떤 역량을 요구하고 있는지 대략 확인할 수 있을 것 같네요. 라인 같은 경우에는 테크니컬 라..
WTD 호주 2024 - 문서 리뷰는 어떻게 하나요? - 효과적인 검토 전략:  좋은 문서와 효과적인 리뷰는 함께 진행되어야 합니다.  문서 작성자가 문서 작성을 쉽게 시작할 수 있도록 모범 사례와 구조화된 프레임워크를 지원합니다. 리뷰는 문서 작성자의 기술 수준이나 문서화 프로세스에 대한 이해도에 따라 맞춤형 피드백을 제공해야 합니다. - 엔지니어의 글쓰기 장려 엔지니어는 기술적 정확성을 기반으로 탄탄한 문서를 작성할 수 있습니다.  구조화된 템플릿과 지침을 제공하고, 테크니컬 라이터가 콘텐츠를 다듬고 개선하면 엔지니어가 효과적으로 문서화에 기여할 수 있습니다. - 문서의 유형 및 작성자의 역할:  엔지니어는 빠르게 바뀌는 세부적인 문서(예: 참조 문서)를 작성하는 데 탁월합니다. 테크니컬 라이터는 명확성, 스토리텔링, 콘텐츠 구조화(예: 설명서)에 중점..
WTD 호주 2024 - 문서 사용자 피드백을 통합하고 인사이트 얻기 Austin Lai의 이전 직장은 DataDog이었습니다. 모니터링, 보안 통합 솔루션을 제공하는 곳이라 조직 내 솔루션을 이용해 문서 사용자 피드백을 분석할 수 있었다고 합니다. 그리고 외부 솔루션으로 hotjar를 사용했습니다. hotjar에서 사용자 설문을 처리하는 기능을 사용했는데, 문서마다 특성에 맞는 피드백을 받을 수 있도록 설계했다고 합니다(이 부분은 제가 잘못 이해한 것일수도 있겠네요. 실제 문서 사이트에 반영된 내용과는 좀 다른 것 같습니다). 슬랙 채널을 사용해 내부, 외부 사용자의 피드백을 받았습니다. 그리고 Metabase를 사용해 데이터를 분석합니다.번역은 transifex를 사용하는데, 번역자가 오타 등을 발견했을때 이를 이슈로 등록할 수 있는 채널이 열려있다고 합니다(정확하지는..

반응형