본문 바로가기

728x90

테크니컬 라이팅

(353)
2024년 11월 테크니컬 라이팅 이런 저런 소식 11월 5일UX 라이터 커리어 패스, 어떤 것들이 있을까요? https://capturephrase.stibee.com/p/96/캡처프레이즈는 매주 금요일 아침 UX 라이팅 해외 아티클을 번역하는 서비스라고 합니다.번역한 원문은 Joshua Gene Fechter가 작년 11월에 작성한 글인데 Technical Writer HQ라는 서비스를 창업한 분이기도 합니다. 테크니컬 라이팅 관련 자격증 코스를 운영하고 다양한 테크니컬 라이터와의 인터뷰를 게시하는 곳이기도 하죠. 눈치채셨겠지만 역시 약간은 마케팅 성격이 강한 글입니다. What is the Technical Writer Career Path? 라는 글도 같이 보시면 좋겠네요. https://www.linkedin.com/pulse/what-tech..
WTD 애틀랜틱 2024 - 누구나, 어디서든 사용할 수 있는 콘텐츠 디자인 발표자의 배우자가 코로나 기간 동안 산책을 나갔다가 개의 습격을 받아 머리의 손상을 입었다고 합니다. 이후 과정에서 활동을 지원해 주는 다양한 도구들을 찾아보면서 접근성에 대해 고민하기 시작했다고 하네요. 접근성에 대한 기본 개념에 대한 설명을 9분까지 진행합니다. 접근성에 대해 어느 정도 알고 있다면 9분 이후부터 시청해도 될 듯합니다. 영상이 발표보다는 홍보 영상 같은 느낌이라서 살짝 이질감이 있긴 합니다. 너무 잘 만든 영상이 주는 부작용이랄까요. 9분 이후부터는 발표자가 속한 기업에서 콘텐츠의 접근성을 검토하면서 어떤 활동을 했는지 설명하고 있습니다. accessScan이라는 유료 서비스를 통해 현재 제공되는 콘텐츠의 접근성을 검토했다고 합니다. 보통은 무료 도구를 사용하는데 전반적인 접근성을 향..
TCN meetup 2024.10 후기 - LINE과 Yahoo의 사내 용어집 Words 이야기 발표 목차가 인상적이네요.   - Words 소개 (첫 시작, 현재) 김지현 님은 일본어를 전공하고 번역 업무로 시작해서 네이버, 라인을 거치면서 자연스럽게 테크니컬 라이터 업무를 같이 하게 되었다고 합니다(일반적인 테크니컬 라이터 커리어이긴 합니다). 번역 업무를 시작할 때도 가장 먼저 시작했던 일이 관련 업무에 대한 용어를 익히는 일이었습니다. 낯선 세계에 적응할 수 있는 가장 빠른 방법이 용어를 익히는 것이라고 생각했다고 하네요. Words를 만든 궁극적인 목표는 구성원 간의 원활한 소통을 위한 것이라고 합니다. 그래서 함께 만드는 사내 용어집이라는 슬로건을 사용하고 있구요. 프로젝트는 2021년 OKR 회의에서 도출이 되어 시작되었고 코로나 시기 재택 업무를 하면서 신입 사원들이 새로운 환경에 적..
WTD 애틀랜틱 2024 - 문서와 대화하는 방식의 변화 LLM의 간략한 역사와 현재 LLM의 제약(제한된 학습 데이터, 환각 현상)을 설명합니다. 이를 보완하기 위한 수단으로 RAG를 설명합니다. RAG는 2가지 타입이 있습니다. 하나는 벡터 기반 RAG입니다. 유사성 검색을 지원하고 매우 빠르게 동작합니다. 그리고 대규모 문서도 잘 처리할 수 있습니다. 하지만 개념들의 관계를 놓칠 수 있습니다. 특히 긴 문서에서 전체적인 맥락을 잘못 이해할 수 있습니다. 그래서 벡타 기반 RAG를 사용하기 위해서는 문서에 대한 전처리 과정이 중요합니다.또 하나는 그래프 기반 RAG입니다. 지식 그래프와 LLM을 결합해서 벡터 기반 RAG를 보완하는 방식입니다. 벡터 기반 RAG의 단점인 개념 간의 관계를 정의하고 있기 때문에 이를 명확하게 설명할 수 있습니다. 단점은 일단..
WTD 애틀랜틱 2024 - 문서 템플릿의 역사 수잔 암스트롱 링크드인 경력을 보면 1986년부터 테크니컬 라이팅 업무를 시작했습니다. 소프트웨어, 장비, 네트워크 등 다양한 분야를 경험했습니다. 2013년부터는 기술 문서 관련 컨설팅 업무를 수행하고 있다고 합니다. 컴퓨터와 온라인이 등장하기 전에는 대부분 매뉴얼이 일정한 템플릿에 따라 작성됐습니다. 어떤 기술 문서를 보든 어떤 순서로 따라 할 수 있는지 직관적으로 이해할 수 있습니다. 또한 특정 작업을 바로 수행해야 할 때도 있어서 개별적인 과업에 대한 문서도 템플릿에 따라 작성이 되었습니다. 하지만 너무 형식적인 템플릿 때문에 실제 과업을 수행하는데 어려움을 겪었습니다.  1980년대 IBM 등에서 기술 문서에는 필수 정보를 담아야 한다는 미니멀리즘이 언급되었고 이런 경향은 최근까지 이어져오고 있..
WTD 애틀랜틱 2024 - 아직도 워드에서 문서를 작성하고 있나요? Lorna Mitchell은 Redocly에서 테크니컬 라이터로 일하고 있습니다. 소프트웨어 개발자 경험이 있고 기술 서적을 출판한 경험이 있습니다. 이번 강연은 어떻게 보면 낯선 환경에 들어서야 하는 테크니컬 라이터를 위한 강연인데.... 너무 원칙적인 이야기하면 해서 그럼 어떻게 해야하는데라는 질문이 나올 수밖에 없네요. Q&A에서도 언급되었지만, 그건 각자 알아서 공부하라는... DevOps의 간략한 정의 - Dev: 소스 컨트롤, 코드 개발 도구 - Ops: 빠른 피드백, 지속적인 개선  이 강연에서 배운 것을 활용하기 위한 전제 조건 - 기술 문서는 텍스트 기반으로 작성되어야 합니다(예를 들어 마크다운 같은. 텍스트 기반 콘텐츠의 장점은 서식을 설정하거나 맞춤법 검사 등 도구와 연결하는데 매우 ..
2024년 10월 테크니컬 라이팅 이런 저런 소식 10월 4일Write the Docs Atlantic 2024 발표 영상Write the Docs Atlantic 2024 발표 영상이 공개됐습니다. 아래 링크에서 영상을 확인하실 수 있습니다. https://www.youtube.com/playlist?list=PLZAeFn6dfHpn8IckCiREggN0f9oWEMomW Atlantic 컨퍼런스는 9월 22일부터 24일까지 온라인으로 진행됐습니다. 올해 마지막 컨퍼런스는 11월 28일부터 29일까지 진행되는 Write the Docs Australia 2024 입니다.요즘은 동영상 요약 기술도 좋아져서 영상을 다 볼 시간이 되지 않는다면 요약된 텍스트로 확인하고 관심 있는 주제의 영상만 살펴보는 것도 좋겠네요. - 온보딩 및 문서화 계획기드온 베렌스마..
2024년 9월 테크니컬 라이팅 이런 저런 소식 9월 5일긴 글 블로그 포스팅 툴이 더욱 강력하게 돌아왔어요!https://wrtn.ai/blog-generator새로운 기능은 아니고 원래 제공되던 기능인데 좀 더 기능이 강화됐습니다. 이전에는 주제를 입력하고 자동생성하는 방식이었는데 이번 개선 사항으로 게시물의 종류, 말투(예시 문장 추가 가능), 인터넷 검색 연동, 핵심 내용, 이미지 첨부 등의 기능이 추가됐습니다. 그리고 3개의 게시물 샘플을 작성해 주고 그중에서 선택해서 바로 블로그를 작성할 수 있게 해 줍니다.몇 가지 테스트를 해보았는데 단순 정보성 블로그를 작성하는 용도라면 나쁘지 않아 보이네요.  9월 10일UX 라이팅을 돕는 AI 툴https://story.pxd.co.kr/1791...UX 라이팅 어시스턴트는 두 단계를 거쳐 문장을 개..

반응형