본문 바로가기

테크니컬 라이팅

(433)
AI The Docs 2025 - AI 에이전트에 대한 쉬운 설명 Ronald Ashri는 4년 정도 의료, 보험 업계 대상으로 대화형 AI 플랫폼을 제공하는 스타트업을 창업해서 운영하고 있습니다. 박사 학위 논문 제목이 "Models for agent - based infrastructures"인데, 굳이 박사 학위 논문을 언급하는 이유는 그 이전부터 에이전트 기반 소프트웨어에 대해 관심을 가지고 있었다는 것을 강조하고 싶었다고 합니다. 그래서 이번 세션에서는 AI란 무엇인지, 에이전트는 무엇인지 간략하게 정리하고 어떻게 에이전트를 만들고 어떤 식으로 활용하는지 안내하는 것이 목적이라고 합니다. 제목은 '쉬운 설명'이라고 붙였지만, 뒤로 갈수록 개념이 복잡해지긴 합니다. 실제 에이전트가 동작하는 것을 아직 제대로 본 적이 없어서 이 부분은 좀 더 공부가 필요할 것 같..
AI The Docs 2025 - 작업 맥락과 Affordances을 고려한 개발자 포털 Kristof Van Tomme는 Pronovix의 CEO입니다. 항상 첫 번째 세션을 담당합니다. 키노트라고 따로 표시하지는 않지만, 대부분의 경우 최근 트렌드를 살펴보는 시간을 가집니다. 이번 세션에서는 자신이 실제로 사용하는 몇 가지 도구를 소개하면서 이야기를 풀어낸다고 합니다(라고 했지만 특정 도구를 살펴보는 것은 아니고 자신이 가지고 있던 어떤 개념에 대한 설명이 주입니다). 첫 번째 등장한 것은 Google NotebookLM입니다. 저는 초기에 잠깐 살펴보고 그 이후에는 잘 활용을 하지 않고 있는데, 최근 어떤 강의에서 강사가 가장 강조하는 도구가 이것이더라구요. 특히 정보를 정리하는 기능은 따라올 것이 없다고 합니다. 발표자 역시 팀에서 NotebookLM을 활용하고 있고 기존에 자료를 분..
2026년 4월 테크니컬 라이팅 이런 저런 소식 4월 2일AI 검색에 인용되는 기술 문서의 조건https://insight.infograb.net/blog/2026/04/01/ai-docs/인포그랩 테크니컬 라이터 Grace(박민영) 님의 글입니다. 중간에 llms.txt에 대한 설명도 나오는데 인포그랩에서는 아래와 같이 사용하고 있네요.https://insight.infograb.net/llms.txt 오라클, 3만 명 해고 단행https://news.hada.io/topic?id=28072전 세계 직원 약 2만~3만 명(전체의 18%) 이 화요일 오전 6시 이메일 한 통으로 해고 통보를 받았다고 합니다. 래딧에 5주전에 입사한 시니어 테크니컬 라이터가 자신도 대상이 되었다는 글을 올렸네요.https://www.reddit.com/r/technica..
WTD 베를린 2025 - 라이트닝 토크 둘째 날 Comedy and technical writing - Adrian Doonan 발표자는 2019년(아마 이전에는 PM)부터 테크니컬 라이터를 시작했고 즉흥연기(Improvisation/Improv)도 비슷한 시기에 시작했다고 합니다. 아마 스탠드업 코미디 비슷한 것을 하는 것 같은데 즉흥연기와 테크니컬 라이팅의 비슷한 부분에 대한 이야기입니다. 1. 너무 어렵게 고민하지 말고 쓰세요. 뭔가 떠오르면 그대로 쓰고 당장 떠오르지 않는 것을 고민하지 마세요. 2. (note에 대한 이야기였는데 어떤 의미인지 모르겠네요 ㅠㅠ) 3. 상대방의 이야기를 경청하세요. 즉흥연기에서는 상대방의 연기에 맞추어 주는 것이 중요한데, 테크니컬 라이터도 개발자나 누군가와 이야기할 때 그들의 이야기를 듣고 적절하게 반응해 주..
WTD 베를린 2025 - 라이트닝 토크 첫째 날 5개의 주제로 라이트닝 토크를 진행합니다. 예전에는 라이트닝 토크를 한 개씩 따로 올렸는데, 요즘에는 그냥 영상 하나로 올리고 있습니다. How to win over someone else’s users (with docs) - Jill Osborne 미국 소프트웨어 회사 Imply(임플라이)의 테크니컬 라이터입니다. 국내에서도 당근마켓 등에서 데이터 분석, 시각화를 위한 도구로 사용한다고 합니다. Lumi라는 이름의 새로운 제품을 출시했는데, 이 제품의 주요 타깃은 기존에 Splunk를 사용하는 대상이었고, 때문에 제품에 대한 문서가 바닥부터 설명하는 것이 아니라 해당 타깃 독자에 맞추어 작성되어야 함을 의미합니다(발표자의 표현에 따르면 자연스럽게 다음 단계처럼 느껴지게 만들었어야 했다고 합니다). I..
WTD 베를린 2025 - 팀 리더로서 개인적인 경험 공유 Kat Stoica Ostenfeld는 에픽 게임즈의 테크니컬 라이터입니다. 링크드인의 현재 역할 소개를 보면 큰 규모의 팀 리더를 맡고 있습니다. 어느 정도 규모인지는 알 수 없지만, 현재는 문서 작성 업무를 거의 하지 않는다고 하는 걸 보면 매니저 역할만으로 벅찬 규모일 것 같네요....Leading a large team of documentarians that create learning material, documentation, and development content for the Epic Games engine ecosystem; Unreal Engine, UEFN, and Fortnite Creative...영상에서는 리더가 되면서 느낀 개인적인 경험을 공유합니다. 딱 문서팀이라서 겪는..
2026년 3월 테크니컬 라이팅 이런 저런 소식 3월 3일사쿠라는 설명을 잘하고 싶어!咲良は上手に説明したい!아직 한국어 번역 일정은 없는 책입니다. 저도 에이전시 인스타에서 책 소개를 보고 알았거든요.저자인 타키자와 시로(滝沢 志郎)의 이전 작품이 소설이길래, 소설가에게 의뢰해서 쓴 작품인가 했는데, 현직 테크니컬 라이터로 일하면서 이 책을 쓴 것이라고 합니다. 아직 따끈따끈한 책이라 리뷰는 많지 않습니다.아래는 에이전시 책 소개입니다.https://www.instagram.com/shinwon.agency/p/DVNErj7CetH/...태풍으로 각 선로가 멈춰 혼란에 빠진 요코하마역. 승객 대응에 쫓기는 아르바이트 역무원 이시카와 사쿠라의 앞에 한 여성——아사쿠라 히비키가 나타난다. 아사쿠라의 매우 알아듣기 쉬운 설명을 듣고 승객들이 납득하는 모습에..
WTD 베를린 2025 - 템플릿 문서 기반 자동화 테스트 조직의 규모가 커지고 제품의 범위가 넓어지면서 사용자 입장에서 딱 원하는 답을 찾기가 점점 어려워졌습니다. 그래서 기존 문서의 문제점을 분석하고 다른 조직의 문서를 검토하면서 How-to 형식의 문서와 튜토리얼 형식의 문서를 통합한 형식을 결정했습니다. 사용자가 원하는 문제를 찾아서 문서에 도달했을 때 아래와 같은 정보를 얻을 수 있습니다. - Prerequisites (바닥부터 문제를 해결해 나갑니다) - Copy/Paste steps (모든 코드는 복사해 바로 적용할 수 있습니다) - Trouble Shooting (트러블슈팅이나 FAQ 정보를 분리하지 않고 같은 페이지 내에서 확인할 수 있습니다) 이와 같은 형식으로 템플릿을 만들고 개발자 그룹에서 템플릿을 채우는 형식으로 검증 과정을 진행했습니다...

반응형