본문 바로가기

728x90

테크니컬 라이팅

(323)
WTD 호주 2023 - 라이트닝 토크 모음 Lightning Talk: Alec Clews - One Word Trick to Automate docs as code 보통 클라우드에서 작업할 때는 뭔가 피드백이 늦게 발생합니다(작업 환경에 따라 다르지만). 그래서 Git 클라이언트에서 사용할 수 있는 Git Hook 옵션을 제안합니다. 발표자료: https://docs.google.com/presentation/d/e/2PACX-1vSE_oFHfPPC8SuP0Nqvco6om2kLCX7DUDkKC_pqHdfcY7He7n5IBLPbZmj1yOlzDIJa9a_m6uAruRa1/pub?slide=id.p 데모: https://gitlab.com/alecthegeek/docs-as-code https://youtu.be/K-T0u-nIaOc?si=-JTc..
WTD 호주 2023 - 요즘 업계는 어떤가요? 이전에는 발표자 2-3명이 Q&A를 하는 형식이었는데 이번에는 Q&A는 각각 진행하고 패널 토의 형식의 새로운 세션이 만들어졌습니다. 2명은 발표를 하신 분이고 1명은 게스트로 초대를 했다고 하네요. 제목처럼 "Tech comms today" 업계 동향을 이야기하는 세션이었는데 어쩌다 보니 그냥 일반적인 이야기로 흘러간 것 같습니다. * 요즘 업계는 어떤가요? 궁금하다면 래딧을 참고하세요. 주로 북미 쪽 이야기가 많긴 하지만 최근 업계가 어떤지 참고할 수 있습니다. 주로 나쁜(?) 이야기가 많은데 좋은 이야기는 보통 이런 커뮤니티에서 하지 않아서 ^^ 불만 그런 것이 많습니다. https://www.reddit.com/r/technicalwriting/ Sarah Maddox 2024.01.23 - [테..
2024년 3월 테크니컬 라이팅 이런 저런 소식 3월 4일 내가 사용하는 맞춤법 검사기는? 2월 23일 맞춤법 검사기에 대한 동영상을 올리면서 진행한 설문입니다(지난달에 올린다고 하는 것을 잊어버리고 3월 첫 소식인 것처럼 ㅠㅠ) https://youtu.be/cDwcUKslhHQ?si=ptn9ytGEcfL-Z3DU 네이버가 80%로 1위, 부산대 맞춤법 검사기가 15%로 2위네요. 다음은 1%. 네이버 맞춤법 검사기는 의외로 사용성이 좋지 않은데도 다음과 비교가 되지 않는군요 ㅠㅠ https://www.youtube.com/post/UgkxRNAeasOal82GqkRToxSXY_NWUxTWETXF A NEW CHAPTER FOR A BOOK APART https://abookapart.com/blogs/press/a-new-chapter-for-a-..
WTD 호주 2023 - 거절에 대처하는 방법 바다 건너 일하는 친구들은 해고에 대해서 그렇게 심각하게 받아들이지 않는다고 이야기하지만(한국에 비해서) 꼭 그런 것은 아닌가 봅니다. 어찌 되었든 해고라는 것은 거절의 다른 표현이기 때문에 누구나 맘이 편한 것은 아닙니다. 발표자 또는 그들의 지인이 겪은 인터뷰, 채용, 해고 등에 대한 이야기를 전달합니다. 그중 흥미로운 에피소드는 테크니컬 라이터 정규직으로 지원했는데 작문 능력이 떨어진다고 피드백을 받으면서 거절당했습니다. 하지만 얼마 후 같은 회사에 계약직으로 일하게 되었고 작문 능력이 뛰어나다며 정규직 제안을 받았다고 합니다. ATS에 대한 이야기도 흥미롭네요. 아마 규모가 어느 정도 있는 회사의 이야기겠지만 적절한 키워드가 포함되어야 하고 기회가 된다면 이력서를 수정해서 다시 지원해야 합니다. ..
WTD 호주 2023 - 스타트업에서는 모든 것을 다 해볼 수 있을까? 이전에는 주로 규모가 있는 기업에서 계약직 또는 정규직으로 일하다가 스타트업에서 일할 기회가 생겨서 합류했다고 합니다. 스타트업에서는 이전에 하고 싶었지만 하지 못했던 이런저런 일들을 좀 더 자유롭게 할 수 있을 것이라 기대했습니다. 하지만 예산 문제, 의사 결정의 책임 문제 등으로 인한 현실에 맞닿게 됐습니다. 다른 세션에 비해 짧은 시간 진행했지만 분위기도 좋고 Q&A 세션도 반응이 좋네요. 다만 하고자 하는 이야기가 어떤 것인지 포인트는 잘 잡지 못하겠네요 ㅠㅠ 파이에 대한 비유는 humble pie 라는 표현으로 겸손하게 행동하다는 의미라고 합니다. 스타트업에서는 내가 중요한 결정을 내리는 경우가 많은데 항상 최선의 결정을 내릴 수는 없다는 것입니다. 그래서 이를 인정하고 겸손한 마음을 가져야 한..
WTD 호주 2023 - 박물관에도 테크니컬 라이터가 있나요? 독특하게 박물관에서 일하는 테크니컬 라이터라고 합니다. 한국에서는 제조 또는 IT 분야에서만 테크니컬 라이터를 생각하는데 다양한 분야에서 테크니컬 라이터가 일하고 있는 것을 알 수 있습니다. 테크니컬 라이터가 되기 위한 경로가 그만큼 많은 것이죠. 박물관에서 테크니컬 라이터는 전시물을 분류하고 이에 대한 기록을 남기고 데이터를 관리하는 등의 일을 한다고 합니다. 그래서 하는 일은 일반적인 테크니컬 라이터가 하는 일과 크게 다르지 않습니다. 감사(Audit) - 작업 대상을 선별하고 우선순위를 정하세요. - 감사 도중에 바로 고칠 수도 있지만 작업은 나중에 하세요. 그렇지 않으면 감사 작업을 마치지 못할 겁니다. 컨트롤(Control) 이 부분은 3가지를 왜 비교해서 설명하는지 잘 이해가~ 뭐 하여간 어떤..
WTD 호주 2023 - 엔지니어가 글을 못 쓰는 것은 당신 탓이다 독특하게 피터라는 주니어 엔지니어를 대상으로 퍼소나를 만들고 그에 대해 설명하면서 시작합니다. 어렸을 때부터 로봇 가지고 노는 것을 좋아했는데 학교에서는 에세이 수업을 무척 어려워했습니다. 엔지니어로 취업을 해서 요구사항을 처리해야 했는데 처리된 요구사항에 대한 문서화(?)를 잘못했다고 합니다. 그래서 성과평가가 좋지 않았고 그로 인한 스트레스로 회사를 그만두었다고 하네요(좀 스토리가 이상하게 흘러갑니다). 그리고 여행을 떠났는데 돈이 떨어져 다시 일을 해야 했다는... 이제 다시 피터 이야기를 다시 살펴봅니다. 첫 번째 직장에서 피터는 심리적인 안전을 보장받지 못했습니다. 부족함에 대해 비난을 받았고 이런 것들이 쌓이면서 불안함이 되었습니다. 에이미 에드먼슨(Amy Demonson)의 책 두려움 없는 ..
WTD 호주 2023 - 제품을 위한 문서에서 사용자를 위한 문서로 전환하기 문서를 작성할 때 사용자 중심으로 그리고 사용자가 실제 해야 하는 일 중심으로 작성하라는 이야기는 많이 있습니다. 하지만 기존에 이미 제품 중심으로 작성한 콘텐츠를 어떻게 작업 중심으로 전환해야 하는지에 대한 경험은 접하기 쉽지 않습니다. 대부분 아예 새로 문서를 작성하든지 기존 문서는 그대로 유지하고 조금씩만 수정하는 경우가 많기 때문이죠. 때문에 이번 세션의 경험은 새롭고 신선하네요. 일하고 있는 곳이 스타트업이기 때문에 테크니컬 라이터이긴 하지만 개발자 커뮤니티를 관리하는 업무도 같이 담당합니다. 커뮤니티 구성원은 약 2천여 명인데 이 정도 규모는 테크니컬 라이터가 피드백을 받고 이를 컨트롤하기에 적당한 숫자라고 합니다. 현재 제품은 5가지 분류로 구분할 수 있습니다. 라이브러리, 에이전트, 클라우..

반응형