테크니컬 라이팅 (381) 썸네일형 리스트형 WTD 포틀랜드 2025 - 규제가 문서화에 미치는 영향 반도체나 의료 기기 등 몇몇 산업군에서는 상당히 많은 테크니컬 라이터가 일하고 있음에도 어떤 일을 하는지 잘 알려져 있지 않습니다. 소프트웨어 같은 경우에는 테크니컬 라이터가 아니라도 기술 문서를 작성하고 블로그 등에 게시할 수 있습니다. 하지만 일부 산업군은 공식적인 문서가 아니면 접하기가 어렵습니다. 그 이유가 바로 규제 때문이죠. 그냥 막 맘대로 글을 쓰면 문제가 될 수 있다는 겁니다. 이번 발표는 그런 배경을 가지고 있는데, 발표 내용은 좀 뒤죽박죽이라 딱 뭔가 정해진 주제가 애매하긴 합니다. 그냥 이런 산업군에서 이런 어려움도 있다 정도로 보면 될 것 같네요. Brainlab은 독일 뮌헨 기반의 의료기기 업체입니다. 6명의 테크니컬 라이터가 있구요. 다른 기술 분야와 다르게 출신이 좀 색다릅니다.. WTD 포틀랜드 2025 - 지원팀과 함께 정성적인 피드백 확보하기 AWS에서 고객이 기술 지원을 받는 절차는 다른 곳과 크게 다르지 않습니다. 먼저 문서를 통해 하고자 하는 일을 어떻게 하는지 살펴보고 뭔가 막히는 부분이 있으면 기술 지원을 받고 심각한 문제가 생기면 요구사항을 등록합니다. 아래 그림에서 설명하는 내용이고 기술 문서 담당자는 이 중 첫 번째 단계(Self service)를 담당하게 됩니다. 문서팀이 가지고 있는 과제는 사용자가 뭔가 막히는 지점 때문에 지원 요청을 하는 케이스가 44%라고 합니다. 즉, 44%의 기능에 대한 문서화가 부족하거나 잘못되었다고 추측할 수 있습니다. 그리고 문제를 검토하면서 지원팀에서 문서를 참고하지 않았다고 합니다. 문서가 잘못된 상태라서 참조할 필요가 없다고 느꼈다는 것이죠. 이런 차이가 생기는 문제는 3가지로 정리할 수 .. WTD 포틀랜드 2025 - 슈퍼 유저 그룹 중심으로 문서 피드백 활성화하기 기술 문서를 작성하면서 테크니컬 라이터가 사용자를 대변한다는 이야기를 많이 합니다. 하지만 많은 경우 테크니컬 라이터의 경험적인 느낌만으로 일을 진행하곤 합니다. 이런 느낌보다는 데이터를 기반으로 사용자가 어떤 것을 필요로 하는지 알아야 합니다. 그래서 사용자 피드백이 중요합니다. 하지만 모든 사용자 피드백이 다 도움이 되는 건 아닙니다. 뉴스에 달리는 댓글처럼 아무 생각 없는 비판적인 댓글도 상당히 많습니다. 도움이 되는 피드백은 아래와 같은 것들입니다. - 제품과 관련이 있는 피드백 - 문제를 확인하고 개선할 수 있는 피드백 - 문서의 품질을 향상시킬 수 있는 피드백 - 제품의 품질을 향상시킬 수 있는 피드백 - 조직의 역량을 향상시킬 수 있는 피드백 사용자 피드백을 얻기 위해 어떤 시도를 해보았나요.. 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)를 사용해 각 제품별로 아바타를 따로 생성합니다. 그렇게 하면 사용자는 자신이 .. 이전 1 2 3 4 5 ··· 48 다음
