본문 바로가기

728x90

테크니컬 라이팅

(353)
API The Docs 2020 - 독자를 잘 알고 그들의 목소리에 기울이기 Uwana Ikaiddi는 BigCommerce라는 온라인 커머스 회사에서 Developer Documentation Manager로 일하고 있습니다. 여기도 외부 파트너사에게 API를 제공하고 이에 대한 문서를 작업하고 있습니다. API The Docs 2020 행사는 WTD 컨퍼런스와 다르게 컨퍼런스 일정이 오프라인처럼 정해져있지 않고 특정 기간 동안 순차적으로 영상을 공개하는 방식을 취하고 있습니다. 작년에는 4월부터 6월까지 시즌 1, 그리고 9월부터 11월까지 시즌 2였습니다. 시즌 1 영상 중 일부 전에 본 것을 제외하고 못 본 영상들만 정리하고 있습니다. WTD 컨퍼런스와 다르게 Q&A는 따로 없습니다. 진행자도 없구요. 라이브로 진행을 하긴 하는데, 발표 내용에 Q&A를 따로 정리하지는 않..
6월 1일 이전에라고 하면 6월 1일을 포함하는 걸까? 구글 포토에서 제공하던 무료 일반 화질 사진 저장 서비스가 2021년 6월 1일부터 종료됐습니다. 구글에서 온 메일을 보면 아래와 같습니다. 2021년 6월 1일부터 새로 추가되는 사진은 저장 용량으로 계산됩니다. 이전에는 일반 화질 저장 시 용량에 포함이 되지 않았거든요. 그런데 다음 단락을 보면 "2021년 6월 1일 이전에"라는 표현이 등장합니다. "이전"은 두 가지 의미를 가집니다. - 이제보다 전 - 기준이 되는 때를 포함하여 그보다 앞 국립국어원 답변을 참고하면 두 번째 의미를 주로 사용한다고 합니다. 즉 "2021년 6월 1일 이전"이라고 하면 6월 1일을 포함한다는 이야기죠. 구글 영문 블로그 역시 before라는 표현을 사용합니다. before은 특정 시점 이전이라는 의미이기 때문에 6월..
임명안 재가. 재가(裁可)는 무슨 뜻일까? 예전 같으면 실시간 검색어에 "재가"가 올라왔어야 하는데, 실검이 없어진 이후로는 그런 재미가 없네요. 뭐 하여간 "재가"는 "결재"와 같은 말입니다. 그냥 임명안이 올라와서 그걸 결재했다는 거죠. 국어사전에는 "안건을 결재하여 허가함"이라고 나와있고 두 번째 의미로 "왕이 직접 안건에 어새(御璽)를 찍고 결재하여 허가하던 일"을 "재가"라고 했다고 합니다. 아마 대통령의 결재를 그냥 표현하기 뭐하니 "재가"라고 대변인은 사용한 것 같습니다. 하지만 행정 용어 순화 편람(1993)에서는 "재가"보다는 "결재"를 사용할 것을 권장하고 있다고 합니다. 하지만 좀 오래된 자료이고 최근 발행된 "한눈에 알아보는 공공언어 바로 쓰기"에서는 "결재"나 "재가" 표현에 대한 언급은 없습니다. https://www.k..
테크니컬 라이터 인턴은 어떤 일을 할까? 우연하게 다른 자료를 찾다가 노스텍사스 대학교(University of North Texas)의 Technical Communication 학과 유튜브 계정을 발견했습니다. 채널 정보를 보니깐 유튜브 가입은 2018년이고 주로 과정 소개 또는 세미나 자료를 올려놓았더군요. 그리고 작년부터 아마도 홍보의 일환이겠지만 학생들의 인턴 경험에 대한 짧은 보고서 영상을 공유하고 있습니다. https://tech.kakaoenterprise.com/59 에서도 살짝 소개되고 있는데 노스텍사스 대학교는 미국 내 테크니컬 라이팅 관련 학과가 있는 10개 학교 중 하나입니다. 오늘의 주인공 Carla Wright는 법과학(法科學, Forensic science)을 전공하다가 맘에 들지 않아 2019년에 영문학 학사를 받..
WTD 포틀랜드 2021 요약 - 라이트닝 토크 모음 라이트닝 토크(Lightning Talk)는 그 날의 프로그램이 모두 끝나고, 모든 참석자가 모여 5분 이내의 가벼운 이야기를 하는 행사입니다. WTD 행사에서는 모든 참석자가 다 참여하지는 않고 신청한 분들만 5분 이내로 발표합니다. 오프라인 행사에서는 빠르게 이야기를 하다 보니 잘 들리지가 않는데 온라인에서는 그건 좀 괜찮네요 ^^ 이번 행사에는 10명이 참여했습니다. (1) Amoreen Armetta - WTD Book Club https://youtu.be/jJ6JSlvaCW8 WTD 슬랙에서 북클럽 채널을 운영하고 있습니다. 그 경험을 공유합니다. https://writethedocs.slack.com/archives/C7YJR1N02 https://www.writethedocs.org/boo..
WTD 포틀랜드 2021 요약 - 테크니컬 라이터를 위한 온보딩 프로그램 만들기 Nicola Yap는 구글 테크니컬 라이터입니다. 20년 차(IBM에서 약 15년 근무)이며 구글에는 2019년에 합류했습니다. 구글에서 테크니컬 라이터 온보딩 팀 리더를 담당하고 있다고 하네요. 2019년에 구글에 왔을 때 테크니컬 라이터를 위한 온보딩 프로그램이 없었다고 합니다. 다양한 온보딩 프로그램이 있었지만 테크니컬 라이터에게 적합한 프로그램은 없었고 입사 후 프로그램 개발을 제안하고 실행했다고 합니다. Level Up: Onboarding that enables writers to thrive https://youtu.be/ROhFB4HL0CU 테크니컬 라이터로 구글에 합류했을 때 기존 온보딩 프로그램은 마치 소방호수로 쏟아내는 물을 받아마시는 느낌이었다고 합니다. 엔지니어 위주의 콘텐츠였기 ..
WTD 포틀랜드 2021 요약 - UX 라이터를 위한 몇 가지 팁 Katherine Karaus는 UX 라이터입니다. 국내에도 토스 같은 금융권 기업에서 많이 강조하고 있는 포지션입니다. 특정 기업에 소속되어 일하는 건 아니고 링크드인 같은 기업 프로젝트를 의뢰받아서 진행하는 프리랜서입니다. 이 분도 커리어가 독특한데 연극을 하다가 고객지원 업무를 몇 년간 했고 카피라이터를 거쳐 UX 라이터로 일하고 있다고 합니다. Invisible influence: the documentation behind UX copy https://youtu.be/efmtoJ6Q-0Q 흥미로운 주제인데, 거의 마지막 세션이라 그런지 집중도가 떨어지나 봅니다 ㅠㅠ 잘 정리가 안되네요. 중간에 소개하는 책이 있는데 "The Content Strategist's Toolkit"라는 책입니다. 국내..
WTD 포틀랜드 2021 요약 - 오픈 소스 문서화 기여에 장애가 있나요? Rin Oliver는 Camunda의 테크니컬 커뮤니티 빌더입니다. 좀 독특한 포지션이긴 하네요. Camuda는 오픈 소스 워크플로우 & 의사결정 자동화 플랫폼입니다. 국내에서는 BPM 솔루션으로 찾아보면 비슷한 제품을 찾아볼 수 있습니다. UX 전문가들이 화면 흐름을 디자인하는 용도로도 사용한다고 합니다. 제목에서 알 수 있듯이 발표자는 여러 신경 발달 장애를 가지고 있습니다. 자폐증(autistic), 실행장애(dyspraxia), 연산 부전증(dyscalculia), 주의결핍장애(Attention Deficit Disorder)를 가지고 있다고 하네요. Writing Documentation with Neurodivergent Open Source Contributors In Mind https:/..

반응형