본문 바로가기

728x90

테크니컬 라이팅

(310)
WTD 포틀랜드 2022 - 라이트닝 토크 모음 Sarah Shockey - Global English: tips and tricks for simplicity and cross-cultural communication Sarah Shockey는 showpad라는 판매 지원 소프트웨어 기업에서 테크니컬 라이터로 일하고 있습니다. showpad의 본사는 벨기에인데 독일, 영국, 폴란드, 네덜란드, 미국에 각각 오피스를 가지고 있네요. 그래서 영어 기반으로 일하고 있지만 누구나 쉽게 이해할 수 있는 글로벌 영어를 사용한다고 합니다. Help center의 자료들이 주로 작성하는 문서인데 영어로 문서를 작성하면서 경험한 것을 공유합니다(해당 사이트는 영어, 프랑스어, 독일어로 제공됩니다). https://help.showpad.com/ 뭐 이런 내용입니다만..
Technical Writer HQ - 메타(페이스북) 테크니컬 라이터 인터뷰 (2) David Darner는 메타(페이스북)에서 테크니컬 라이터로 일하고 있습니다. 링크드인에는 계약직이라고 표기하고 있네요. https://www.linkedin.com/in/david-darner-09576043/ 연봉은 약 125000달러라고 합니다. 메타의 평균 연봉이 대략 15만 달러인 것에 비하면 10년 차 테크니컬 라이터로서 그리 큰 금액은 아닌 듯합니다(물론 기본급만 이야기한 것이라면 좀 다르겠지만 계약직이라 어떨지 모르겠네요. 뒷부분에서 실제 일하는 시간은 많지 않다고 하는 걸 보면 또 뭔가 있는 것 같기도 하지만). * comparably.com 이라는 사이트에서는 대략 평균 연봉은 11만 달러라고 합니다. 2만 5천 달러부터 시작하는 걸 보면 조사 대상자가 모두 풀타임은 아닌 듯하네요. ..
도큐사우루스에서 지원하는 마크다운 기능 (6) 도큐사우루스는 기본 마크다운 명세를 지원하며 몇 가지 추가 기능을 사용할 수 있습니다. 프런트 매터 문서 URL이라든지 제목, 상세 설명 등의 메타 데이터를 처리하기 위해 YFM(YAML front matter) 형식을 지원합니다. https://assemble.io/docs/YAML-front-matter.html 사용할 수 있는 전체 필드는 plugin-content-docs 문서에서 참고할 수 있습니다. https://docusaurus.io/docs/api/plugins/@docusaurus/plugin-content-docs#markdown-front-matter 필드 중 제목과 관련된 필드는 우선순위에 따라 적용됩니다. 기본적으로 제목은 파일명이 적용되며 그다음에는 마크다운 문서 내 # hel..
WTD 포틀랜드 2022 - 밋업을 만들고 참여해봅시다 개인적인 정리 WTD 밋업 코디네이션 팀에 대한 이야기입니다. Rose Williams는 팀을 리드하고 있고 starburst라는 회사에서 인포메이션 엔지니어로 일하고 있습니다. Alyssa Rock은 VMware에서 테크니컬 라이터로 일하고 있구요. Quorum meetup 프로그램을 운영하고 있습니다. Quorum meetup은 줌 기반으로 온라인 상에서 진행되며 코로나 이후 새롭게 진행하는 프로그램이라고 합니다. https://www.writethedocs.org/team/#meetups https://www.writethedocs.org/meetups/index.html#current-meetups-quorum https://github.com/write-the-docs-quorum/quorum-..
Technical Writer HQ - 아마존 테크니컬 라이터 인터뷰 (1) 테크니컬 라이터 직무에 대해서만 인터뷰한 자료(글, 영상)는 그렇게 많지는 않습니다. 업무와 관련된 이야기는 좀 민감한 부분도 있고 컨퍼런스 발표와 다르게 뭔가 내 커리어로 삼기도 애매해서 그런 듯합니다. Technical Writer HQ 유튜브에서는 몇몇 테크 기업 테크니컬 라이터를 인터뷰하고 그 영상을 공유하고 있습니다. 아마 라이브 인터뷰였는지 라이브 댓글도 포함되어 있고 인터뷰 중간에 영상이 멈추거나 음성이 나오지 않는 등의 모습을 그냥 편집 없이 보여줍니다(인터뷰이는 별로 좋아하지 않을지도). 오히려 이런 모습 덕분에 좀 더 솔직한 테크니컬 라이터 인터뷰가 아닌가 싶네요. 영상의 내용을 개인적인 관심으로 정리했으며 영상의 모든 내용을 담고 있지는 않습니다. 딱히 순서는 없고 제목은 "Techn..
논문 살펴보기 - 전자 제품 사용 설명서의 문장 표현 분석 (남경완) 남경완 교수의 사용 설명서 논문 시리즈입니다. 나중에 책으로 펴내시면 어떨까 싶네요. 2022.01.21 - [테크니컬 라이팅] - 논문 살펴보기 - 전자 제품 사용 설명서의 어휘 사용 양상 (남경완) 2022.01.20 - [테크니컬 라이팅] - 논문 살펴보기 - 전자 제품 사용 설명서 텍스트 분석 (남경완) "전자 제품 사용 설명서의 어휘 사용 양상"에서 이어지는 글이라고 설명하고 있습니다. 2020년 2월부터 진행한 감수 작업이 계속 이어지고 있는 듯합니다. 해당 논문은 2022년 3월에 작성되어 4월 어문논집에 발표됐습니다. KCI에서 무료로 원문을 내려받을 수 있습니다. 전자 제품 사용 설명서의 문장 표현 분석 –테크니컬 라이팅의 실제– (kci.go.kr) 전자 제품 사용 설명서의 문장 표현 ..
WTD 포틀랜드 2022 - 테크니컬 라이터와 개발자의 협업에 대해 개인적인 정리 원래 이름은 Ian Dees였습니다. Ian Dees라는 이름으로 테스팅 관련 분야에서 꽤 많은 책을 쓴 것을 찾아볼 수 있습니다. https://www.amazon.com/Ian-Dees/e/B002BM9GLE 개인 스타일링 서비스를 제공하는 스티치 픽스(STITCH FIX)라는 곳에서 2019년부터 소프트웨어 엔지니어로 일하고 있습니다(라고 이력서에는 나와있는데 발표를 보니 briza.com에서 일한다고 합니다). Cowpoke는 카우보이를 뜻하는 미국식 구어라고 합니다. Wrangler도 카우보이인데 주로 목장 내에서 말을 돌보는 일을 하는 이들을 뜻한다고 합니다. Cowpoke는 외근직, Wrangler는 내근직이라고 할 수도 있겠네요. 개발자와의 협력을 강조하며 여러 가지 장점을 ..
WTD 포틀랜드 2022 - 엔지니어를 문서 전문가(?)로 만들기 개인적인 정리 va.gov는 재향군인회 정도로 번역할 수 있을 것 같네요. Liani Lye는 PM이고 Gretchen Maciolek는 UX 라이터입니다(이들 외에도 Amy Goldman과 Mike Chelen도 등장합니다). 아. 그런데 재향군인회 소속은 아니고 adhoc.team이라는 곳에서 서비스를 구축했나 보네요(주로 연방정부 쪽 프로젝트를 담당하는 듯합니다). 프로젝트 레퍼런스를 https://adhoc.team/programs/va-gov/ 에서 확인할 수 있습니다. va.gov를 운영하기 위한 10여개의 팀과 많은 팀원들이 있었고 콘텐츠를 담당하는 테크니컬 라이터는 3명이 있었습니다(정확하게 합류 시점은 잘 모르겠습니다. 아마도 어느 정도 프로젝트가 진행된 이후에 참여한 듯합니다). 플랫폼..

반응형