본문 바로가기
728x90

테크니컬 라이팅

 (310)
Technical Writer HQ - 스플렁크(Splunk) 테크니컬 라이터 인터뷰 (6) Brittany Burrell은 Splunk의 테크니컬 라이터입니다. 지원팀의 지원 정책, 프로세스 전반에 대해 문서화하는 업무를 담당하고 있습니다. 대학에서 테크니컬 커뮤니케이션을 전공했고 졸업 이후 바로 관련 기업에 취업을 했습니다. 몇 개 작은 기업과 IBM을 거쳐 Splunk에서 2019년부터 일하고 있습니다. 영상 시작 부분에서 "The Product is Docs"라는 책을 언급하는데 Brittany Burrell은 이 책에 직접적으로 참여하지는 않은 듯합니다. 해당 책 후기 마지막에 참여한 스태프들의 이름을 언급하는데 그녀의 이름은 보이질 않네요. 테크니컬 라이터에게 중요한 것은 자신이 모든 것을 알 수 없다는 사실을 이해해야 합니다. 물론 자신이 작업할 영역에 대한 기본적인 이해는 필요하며..
REST Docs는 뭔가요? 토스의 SLASH 22 영상을 보다가 배포 관련 설명에서 "...Rest Docs 테스트를 거쳐 사내 API 카탈로그에 게시하고..."라는 말이 귀에 들어왔습니다. 뭔가 문서화 이야기를 하는 것 같은데 처음 들어보는 표현이라 찾아보았습니다. 구글 검색에서 REST Docs 사이트가 가장 먼저 노출되고 그 다음에 나오는 것은 국내 개발자들이 작성한 글이었습니다. 배민 정산시스템 API 문서를 위키에서 Rest Docs로 전환했다는 글이 가장 처음에 나오고(아마 워낙 인기 있는 글이라 그런가 봅니다) 그 외에도 꽤 많은 글이 나옵니다. 한국어가 아닌 글을 찾으려면 한참 밑으로 내려가야 합니다. 그렇다면 이미 많은 곳에서 API 문서를 작성할 때 REST Docs를 사용한다는 거 같네요. 하지만 WTD 슬랙에..
갑자기 '연동'이라는 단어가 어색하게 느껴져서 페이먼트 관련 문서를 보다가 갑자가 '연동'이라는 단어가 뭔가 어색하게 느껴졌습니다. 찾아보니 꽤 많이 사용하는 표현인데 그 정확한 의미를 알지 못하는 것이 아닌가 싶었던 거죠. 물론 이 글에서도 딱히 정답은 없습니다. 사전적 의미 연동 連動/聯動 한자 표기는 2가지 형태로 사용하는데 의미는 같습니다. 표준국어대사전에서는 '기계' 관련 의미만 등록되어 있는데 고려대한국어대사전에서는 '경제' 관련 의미가 같이 올라와있습니다. 실제 뉴스를 검색해보면 환율, 주가 등을 설명하면서 많이 사용되는 표현입니다. - 표준국어대사전 기계나 장치 따위에서, 한 부분을 움직이면 연결되어 있는 다른 부분도 잇따라 함께 움직이는 일. - 고려대한국어대사전 물가 정책 따위에서, 어떤 것의 값이 오르내림에 따라 그와 관련되는 것..
UI 텍스트 번역의 어려움 일반 문서 번역은 앞뒤 맥락이 있으니 어느 정도 감을 잡고 번역할 수 있습니다. 하지만 UI 텍스트의 경우에는 좀 다릅니다. 해당 문장 또는 단어가 어떤 의미로 쓰인 것인지 파악하는 것이 쉽지 않습니다. 해당 화면 이미지를 직접 보면서 번역한다면 쉽겠지만 그렇지 않다면 전혀 다른 의미나 의도로 번역하게 될 수 있습니다. (저는 전문 번역 작업을 하지 않습니다. 그냥... 구글 번역기의 힘을 빌어 흉내만 내는 정도입니다). 예를 들어 다음과 같은 단어의 경우가 그렇습니다. 번역할 대상은 'to select'이고 그 아래에 간단한 설명이 포함되어 있습니다(이런 설명도 과분한 상황이죠). "The explanatory text of the action for the enter key"라는 설명으로 보면 사용자..
Netflix 에러 U7353-5101 점심시간에 넷플릭스를 잠시 접속하는데 해당 시간대 사용자가 몰려서 그런지 간혹 버퍼링이 심할 때가 있습니다. 그래서 윈도우용 넷플릭스 앱을 설치하고 볼 영상을 내려받고 봅니다. 근데 가끔 U7353-5101 이라는 에러 코드가 뜨면서 저장한 영상 재생이 되지 않습니다. 구글에서 해당 코드를 찾아보면 안내 페이지가 나오긴 합니다. https://help.netflix.com/ko/node/100647 그리고 문제 해결 팁으로 앱 재설정을 권장합니다. 근데 흥미롭게도 해당 에러는 저장한 영상(또는 영상 정보)에 문제가 있는 것이고 그냥 해당 영상을 삭제하고 다시 내려받으면 해결됩니다. 굳이 복잡하게 앱 재설정을 할 필요가 없는 것이죠. (물론 문제가 반복된다면 재설정이 뭔가 해결해줄 수도 있을 듯한데 이건 ..
Technical Writer HQ - 레드햇 테크니컬 라이터 인터뷰 (5) 2020년에 레드햇에 합류해 테크니컬 라이터로 일하고 있습니다. 노스캐롤라이나 주 주립대학에서 테크니컬 커뮤니케이션을 전공했고(링크드인 프로필과 살짝 다르게 원래는 역사를 전공했고 테크니컬 커뮤니케이션은 부전공이었다고 합니다) 2019년부터 3년간 석사(Master's degree) 과정까지 밟았습니다. 학부 졸업 이후 테크니컬 라이터로 일하면서 계속 공부를 한 케이스입니다. 레드햇에 오기 전에는 계약직이나 인턴 과정을 주로 했는데 이런 작업들을 통해 자신의 커리어를 쌓을 수 있고 포트폴리오를 만들 수 있다고 합니다(물론 국내에서는 테크니컬 라이터로 인턴 과정을 하는 것이 쉽지는 않습니다). 레드햇은 문서 작성 시 내부에서 개발된 모듈식 시스템을 사용하는데 처음 이를 다루기가 무척 힘들었다고 합니다. 이..
Technical Writer HQ - Point B 테크니컬 라이터 인터뷰 (4) 시카고 지역 은행들의 커뮤니케이션 관련 계획을 수립하고 관리해주는 역할을 한다고 합니다. Point B 라는 컨설팅 기업에서 일하고 있는데 2022년 4월부터 일하기 시작했으니 실제 이 업무를 담당한 건 얼마 되지 않네요. 하여간 자신을 '커뮤니케이션 리드/테크니컬 라이터'로 소개하고 있습니다. Point B에서 하는 일 중에 하나가 커뮤니케이션 관리라고 하는데 어떤 식으로 진행되는지는 자세히 설명하지는 않습니다. Point B 사이트에 올라온 시카고 지역 구인 공고를 보면 커뮤니케이션 담당자를 뽑고 있긴 한데 CCMP(Certified Change Management Professional)같은 인증을 받은 변화 관리 전문가를 선발하고 있는 것 같긴 합니다. 링크드인에서 확인한 경력을 보면 다양한 기업..
Technical Writer HQ - Zoox 테크니컬 라이터 인터뷰 (3) Krista Barber는 자율주행 로보택시를 만드는 죽스(Zoox)라는 곳에서 테크니컬 라이터로 일하고 있습니다. 그 이전에는 테슬라 모터스에서 5년 정도 일했구요. Zoox에는 2018년 합류했습니다. Zoox는 아마존에서 2020년 약 1조 4000억 원에 인수했죠(사실 Zoox라고 해서 그냥 자그마한 스타트업이라 생각했습니다 ㅠㅠ). 테슬라에서도 제조 쪽 테크니컬 라이팅 업무를 담당했어서 전반적으로 자동차 하드웨어 분야에 많은 배경 지식을 가지고 있다고 합니다. 대학에서는 영어를 전공했고 친구와 같이 작은 컨설팅 회사에서 일하다가 전공 때문에 테크니컬 라이팅 업무를 떠맡게 되었다고 합니다. 영어를 전공했어도 테크니컬 라이팅은 생소한 분야라서 인근 대학에서 과정을 탐색했고 2006년에 샌프란시스코 ..
반응형

티스토리툴바