본문 바로가기

728x90

테크니컬 라이팅

(353)
2023년 12월 테크니컬 라이팅 이런 저런 소식 12월 4일 테크니컬 라이팅에 프롬프트 엔지니어링 활용하기 https://insight.infograb.net/blog/2023/11/29/tw-prompt 테크니컬 라이팅에 프롬프트 엔지니어링 활용하기 이 글에서는 프롬프트 엔지니어링을 테크니컬 라이팅에 활용해야 하는 이유를 살펴보고요. 이 기술을 도입할 만한 테크니컬 라이팅 업무, 효과적인 테크니컬 라이팅용 프롬프트 요건, 테크니컬 insight.infograb.net 제목과는 다르게 프롬프트 엔지니어링이라기보다는 챗 GPT 활용하기가 좀 더 적절하지 않나 싶습니다. 본문 내에 뤼튼을 사용하는 사례가 보이기도 했는데 뤼튼은 12월 20일부터 기존 유료 서비스를 무료로 전환한다는 발표를 했습니다. 뤼튼 서비스의 초기 타켓이 테크니컬 라이팅 분야이기도 했..
WTD 애틀랜틱 2023 - 단일 소스 용어집 구축하기 플랫폼 간에 같은 기능을 설명하기 위해 다른 용어를 사용하는 문제가 있습니다. 이런 문제를 해결하기 위해 다양한 조직 담당자들이 워킹그룹을 만들고 기존에 사용하던 용어, 정의를 모두 정리했습니다. 그리고 모든 토론 과정을 GitHub에 기록으로 남겼습니다. 만들어진 용어집은 다양한 서비스에서 제공되기를 원했습니다. 기술지원포털뿐 아니라 번역 관리 시스템 등에서도 말이죠. 그리고 실제 서비스에서도 용어에 대한 정의를 확인할 수 있어야 했습니다. 이를 구현하기 위해서는 기계가 읽고 처리할 수 있는 단일 소스의 거대한 용어집이 구현되어야 했습니다. Hugo 같은 경우 기능을 확장하기 위해 Modules을 지원하고 있습니다. 그래서 용어집을 Hugo Module로 만들고 이를 각 서비스에서 가져와 사용하도록 구..
WTD 애틀랜틱 2023 - 테크니컬 라이터와 처음 협업해본 UX 전문가의 이야기 Katie Riker는 UX 전문가로 12년 차입니다. 지금은 레드햇에서 일하고 있구요. 10년 차까지는 테크니컬 라이터와 일해본 경험이 없다고 합니다. 그러다가 최근에 새로운 제품을 개발하는 조직에 합류하면서 테크니컬 라이터와 함께 작업을 할 기회가 있었는데 정말 놀라운 경험이었다고 합니다. 그 이유는 UX와 테크니컬 라이팅의 역할(범위)이 비슷하기 때문이라고 생각했답니다. 테크니컬 라이터와의 협업 중 하나는 UI 라이팅 작업입니다. 테크니컬 라이터는 각 제품(서비스) 간 같은 용어를 다른 의미로 사용하는 것을 분석하고 이를 조정하는 작업을 이끌어주었다고 합니다. 아래 그림처럼 표로 만들어서 분석하는 방법이 인상적이네요. 그리고 새로운 용어를 사용하게 되면 이를 정의하고 어떤 과정을 거쳐 만든 용어인지..
TCN 2023년 10월 밋업 정리 10월 26일 저녁 8시부터 진행된 행사입니다. 저녁 8시라는 시간이 좀 애매한데... 요즘 온라인 밋업이나 콘퍼런스는 7시, 8시 이 정도 시간에 진행을 하더라고요. 하여간 이번에도 라이브는 시청하지 못하고 거의 한 달이 지나 이제야 정리해 봅니다. 참고로 아래 정리한 내용은 발표한 내용을 그대로 옮긴 건 아니고 중간중간 잡다한 개인적인 의견이 포함되어 있습니다. 지난 2월 밋업과 마찬가지로 3개의 세션으로 구성되어 있습니다. (1) 한 셋트의 매뉴얼이 만들어지기까지 - 김세혁 김세혁 님은 네이버 TCN 카페를 만들고 운영하고 있는 분입니다. 닉네임은 unartist이고 현재 한화정밀기계에서 테크니컬 라이터로 근무하고 있다고 합니다. 발표를 시작하기 전에 제품 소개 영상을 살짝 보여주었는데요. HM52..
WTD 포틀랜드 2023 - 라이트닝 토크 모음 오프라인 행사라서 아마 현장에서도 발표자를 받아서 진행한 것 같습니다. 영상으로 공개된 것이 11개네요. (1) Lightning Talk: Jewel Darger-Sacher - Why :pray: emoji ain't :high-five: 이모지는 어떻게 보면 하나의 표준인데 문화에 따라 다른 의미로 받아들일 수 있다는. 때문에 번역 시에 같은 이모지를 사용하지 않고 필요에 따라 다른 이모지 아니면 다른 텍스트로 번역해야 한다는 겁니다. 참고로 토스에서는 2022년 2월 토스페이스를 공개하면서 일부 이모지를 한국 문화에 맞게 수정했었는데 표준으로 등록된 이모지를 전혀 다른 해석으로 만들어 논란이 되었습니다. 결국에는 표준에 맞게 변경하는 것으로 다시 배포를 했습니다. 관련 기사: https://n.n..
2023년 11월 테크니컬 라이팅 이런 저런 소식 11월 13일 Fedora Docs writing workshop 11월 16일 8시부터 8시 30분까지 진행되는 온라인 행사입니다. 진행 시간이 좀 애매하긴 한데요. 한국 시간으로는 오후 5시부터라고 합니다. 주제를 보면 실제 지식 전달 목적보다는 우리 팀에서 이런 식으로 일하고 있는데 같이 해볼 생각이 있니 같은 느낌이네요. https://calendar.fedoraproject.org/meeting/10617/ 11월 23일 Dev Chat" 컨퍼런스 https://devocean.sk.com/events/view.do?id=188 12월 1일 금요일 진행되는 컨퍼런스입니다. 데브렐을 대상으로 하는 행사지만 많은 기업에서 데브렐 조직 안에 문서화 담당자가 속해있거나 연결되어 있어서 참석하셔도 좋을 ..
2023년 10월 테크니컬 라이팅 이런 저런 소식 10월 10일 연휴도 있고 해서 게으름 모드였다가 이제야 10월 첫 소식을 올립니다. 한글 맞춤법 검사기 개발…30년째 취준생 등불 됐다 10월 9일 한글날에 올라온 한국어 맞춤법/문법 검사기를 만든 부산대 권혁철 교수님 인터뷰 기사입니다. 요즘에는 맞춤법 검사기 대신 챗GPT에 맞춤법, 문법뿐 아니라 표현까지도 수정해 달라고 요청하는 시대지만 무료로 이런 서비스를 대중적으로 사용할 수 있게 해주는 것이 얼마나 큰일인지 모릅니다. ...하지만 챗GPT 등 무서운 속도로 발전하는 학습형 AI가 머지않아 맞춤법 검사기 기능을 대체할 것으로 본다. 그는 “스스로 학습하는 AI와 비교하면 사람이 연구해 규칙을 만들고 업그레이드하는 방식은 비효율적일 수밖에 없다”며 “언젠가 밀려나겠지만... https://n.n..
2023년 9월 테크니컬 라이팅 이런 저런 소식 9월 6일 - 카카오페이 기술 블로그는 어떻게 만들었을까요? 라는 제목의 글입니다. 기획보다는 구현 기술 쪽에 초점을 맞추어 작성한 글이네요. Gatsby로 만들고 Astro로 마이그레이션 한 경험도 담겨 있습니다. https://tech.kakaopay.com/post/kakaopay-techlog/ 카카오페이 기술 블로그 내용 중 용어집 개발과 관련된 글도 있습니다. 물론 자세한 이야기는 없지만 용어집을 봇 형태로 개발하고자 한다면 참고할만한 내용입니다. https://tech.kakaopay.com/post/dictionary-bot/ - WRITE THE DOCS ATLANTIC 2023 행사 티켓이 마감된다는 소식입니다. 행사는 9월 10일부터 12일까지 온라인으로 진행됩니다. 세션 영상은 아마..

반응형