본문 바로가기
728x90

테크니컬 라이팅

 (353)
논문 살펴보기 - 전자 제품 사용 설명서의 문장 표현 분석 (남경완) 남경완 교수의 사용 설명서 논문 시리즈입니다. 나중에 책으로 펴내시면 어떨까 싶네요. 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명이 있었습니다(정확하게 합류 시점은 잘 모르겠습니다. 아마도 어느 정도 프로젝트가 진행된 이후에 참여한 듯합니다). 플랫폼..
WTD 포틀랜드 2022 - 문서 통계를 믿지 마세요 개인적인 정리 Kumar Dhanagopal은 오라클에서 13년간 기술지원, 테크니컬 라이팅, 커뮤니티 업무를 담당했고 2021년 구글로 자리를 옮겨 현재는 솔루션 라이터라는 업무를 맡고 있습니다. 이게 솔루션 라이터라고 해서 뭔가 특별한 건 아니고 소속 조직에 따라 이름이 다른 것 같네요. https://careers.google.com/jobs/results/92138733240754886-technical-writer-cloud-industry-solutions/?jlo=en_US 이번 세션에서는 구글 애널리틱스에 대한 이야기인데요. 구글 테크니컬 라이터가 이야기하는 것이니 뭔가 숨겨진 팁도 공개를 하지 않을까 싶습니다(물론 세션 발표에 대한 내용은 개인적인 의견이며 구글의 공식적인 의견은 아니라고..
Technical Writer HQ에 대해 페북에 올라온 게시물 중 Technical Writer HQ 유튜브 영상에 대한 링크가 있었습니다. 아마존, 메타, 레드햇 등의 테크니컬 라이터와의 인터뷰와 함께 테크니컬 라이터에 대해 궁금한 몇 가지 정보를 알려주는 영상이 올라와있더군요. 구독자는 대략 2900명 정도이고 가장 많은 조회수는 1만 회입니다. 채널 소개 정보를 보면 Technical Writer HQ is building the world’s most trusted resource for technical writing. 라고 설명하고 있는데 기술 문서에서 금지(?)하고 있는 "world’s most" 같은 근거 없는 문구를 사용하는 걸 보면 이 채널은 뭔가 의심스럽네요. 유튜브 채널은 다시 https://technicalwriterhq..
도큐사우루스에서 블로그 운영하기 (5) 개인이 문서 도구를 사용할 때는 대부분 개인 블로그를 운영하기 위한 경우가 많습니다. 네이버 블로그를 써도 되지만 뭔가 자유롭지 못하고 티스토리나 워드프레스는 어느 정도 수정을 할 수 있지만 그럼에도 제약이 있어서 불편합니다. 물론 도큐사우루스 같은 문서 도구를 사용하더라도 원하는 대로 꾸미려면 많은 수고가 필요해서 대부분 기본 템플릿 정도로만 사용하긴 합니다만~ (뭐 정 마음에 들지 않으면 직접 개발해야죠~). 기본 템플릿에서 블로그 만들기는 간단합니다. 사실 이미 만들어져 있고 그냥 새로운 포스트만 추가하는 겁니다. blog 폴더 아래에 YYYY-MM-DD-제목 형식으로 파일명을 만들면 끝입니다. 파일명에 있는 날짜를 기준으로 새로운 글이 추가되고 화면에 표시됩니다. 끝. 날짜 폴더에서 블로그 포스트..
WTD 포틀랜드 2022 - 콘텐츠 재사용 시 유의할 점은 어떤 것이 있나요? 개인적인 정리 Anna Gasparyan는 JetBrains 입사 8년 차입니다. 테크니컬 라이터로 시작해서 2020년부터는 PM을 담당하고 있습니다. 자신의 이력을 모자로 표현한 일러스트가 인상적입니다. 테크니컬 라이터 경력은 약 15년이라고 합니다. (내부 문서 작성 및 배포 시스템 개발을 담당하고 있는 듯 한데 상용으로 공개된 제품인지 내부에서 쓰는 것인지 명확하지는 않습니다). (Writerside라는 제품을 준비하고 있네요. 아직은 공개전이긴 합니다). https://lp.jetbrains.com/writerside/ JetBrains은 다양한 언어와 기능을 지원하는 개발 도구를 만들고 있는데요. 각 개발도구는 공통적인 기능이 있고 특화된 기능이 있습니다. 12개의 개발 도구를 만든다면 문서 역..
Storyblok 체험해보기 (4) Structures of Content https://www.storyblok.com/docs/guide/essentials/content-structures 의 내용을 요약한 겁니다. Getting Started에서 용어에 대한 설명이 바로 나오면서 자세한 내용은 이 문서를 참고하라고 하죠. 하지만 이미 용어가 나오는 순간 이게 무슨 이야기지 싶어서 Getting Started를 보기 전에 이 문서를 먼저 보거나 같이 보는 것이 좋을 듯합니다. 제목은 Structures of Content이지만 그냥 각 용어에 대한 개념 설명입니다. 콘텐츠 구조와 연결되어 있긴 하지만 전체 구조가 딱 쉽게 이해되지는 않네요. 다루는 용어는 아래와 같습니다. Account 같은 건 다른 서비스와 딱히 별 다른 것이 없어서 여기서 설명을 했어야 했나 싶기도 합..
반응형

티스토리툴바