테크니컬 라이팅/WTD 컨퍼런스 (103) 썸네일형 리스트형 WTD 프라하 2021 - 오픈소스 커뮤니티에서 책 쓰기 가이드 felicity brand는 여러 테크 기업에서 테크니컬 라이터로 일하다가 지금은 테크니컬 커뮤니케이션 컨설턴트라는 이름으로 활동하고 있습니다. "Open Strategy Partners"라는 곳에 소속되어 활동하는 듯합니다. 이번 세션은 책 쓰기에 대한 이야기인데 발표자는 이번에 처음 책(The TYPO3 Guidebook: Understand and Use TYPO3 CMS)을 써보았다고 하네요. 그 이전에는 제품 매뉴얼(대부분 온라인 기반)만 작성했어서 색다른 경험이었다고 합니다. 개발자들은 너무 바빠서 책을 쓸 시간이 없어서(발표자의 주장) 커뮤니티에서 책을 써달라고 발표자가 속한 에이전시에 의뢰했다고 합니다(정확하게 의뢰처가 커뮤니티인지는 모르겠습니다). 그래서 여러 명의 저자를 섭외되어 진행(.. WTD 프라하 2021 - 문서에 대한 피드백 받기 Kevin Hwang은 Splunk에서 테크니컬 라이터로 일하고 있습니다. Splunk는 "The Product is Docs"라는 책을 2020년 펴내기도 한 곳입니다. https://www.splunk.com/en_us/blog/splunklife/the-product-is-docs.html The Product is Docs The Splunk doc team has written a book about how they do what they do www.splunk.com 제품에 대한 피드백은 기술지원이나 고객지원팀을 통해 들어오지만 문서에 대한 직접적인 피드백을 받기는 쉽지 않습니다. 온라인 문서라면 댓글이나 좋아요 같은 기능을 통해 피드백을 받을 수 있지만 그렇지 않은 경우에는 일부러 문서에 .. WTD 프라하 2021 - 멀리서 함께 일하기 Anna Korinna Németh Szabó는 퀘스트 소프트웨어에서 테크니컬 라이터 & 어드바이저로 일하고 있다고 합니다. 실제 링크드인에서도 그렇게 소개하고 있구요. 퀘스트 소프트웨어라고 해서 게임 회사인가 싶었는데 그건 아니고 국내에는 Toad라는 데이터베이스 관리 도구로 잘 알려져 있는 회사입니다. 예전에는 대부분 Toad를 사용했는데 요즘에는 좀 더 경량화된 도구도 있고 온라인에서도 사용할 수 있는 도구도 있어서~ 하여간 왜 게임 회사라고 오해했냐면 자기 소개에서 테크니컬 커뮤니케이션 길드 같은 표현을 써서 그랬습니다. "technical communications guild"로 구글에서 검색해보면 이 분 이름만 나오는 걸 보면 그냥 혼자 쓰는 표현인 듯하네요. 30분 정도가 발표이고 나머지 1.. WTD 프라하 2021 - 지식을 시스템으로 만드는 건 쉽지 않다 Victor Sluiter는 Saxion University의 Research Engineer입니다. WTD와는 좀 거리가 먼 것 아닌가 싶기도 하지만 지식 정보를 구축한다는 면에서는 연결되는 부분이 많겠죠. 다른 대학 연구소처럼 기업과 협업을 진행합니다. 로고도 대학보다는 기업 로고처럼 보입니다. 짧은 발표인데 앞부분 꽤 많은 시간을 연구소 소개 등등에 사용하고 이제 어떤 일을 했는지 이야기가 나옵니다. 분산된 정보를 직관적으로 접근할 수 있는 방법을 고민합니다. 이건 아마도 기업에서도 마찬가지일 겁니다. 담당자가 바뀌면 다른 도구를 시도해보고 정보가 쌓이다가 담당자가 바뀌면 또 도구가 바뀝니다. 그렇게 몇 차례 지나다 보면 아래와 같이 여러 채널에 정보가 분산되어 있죠. 이런 상황의 문제점은 아무도 .. WTD 프라하 2021 - API 설계에 참여하기 Fabrizio Ferri Benedetti는 Splunk에서 테크니컬 라이터로 일하고 있습니다. 링크드인 프로필을 보면 테크니컬 라이터와 함께 API 디자이너라고 자신을 소개하고 있습니다. 이번 세션의 주제는 일반적으로 엔지니어의 영역이라고 생각하던 API 디자인을 테크니컬 라이터가 어떤 식으로 참여하고 주도할 수 있는지 그리고 왜 테크니컬 라이터가 API 디자인에 강점을 가지는지를 설명합니다. 이 분 프로필 옆에 스피커 아이콘이 있는데요. 처음 보는 거라 확인해보니 자신의 이름 발음을 녹음하고 이를 방문자가 들을 수 있도록 하는 것이라고 합니다. 흔히 사용하지 않은 이름이라면 발음을 어떻게 해야 하는지 애매할 수 있는데 꽤 유용한 기능이네요. 관련 설명을 보면 데스크탑에서는 편집 기능을 제공하지 않고.. WTD 프라하 2021 - 사과문 작성하기 Ryan Macklin는 구글 테크니컬 라이터입니다. 링크드인 프로필을 보면 테크니컬 라이터이면서 empathy advocate라고 설명하고 있는데요. 이번 주제는 후자에 관한 것입니다. https://empathyadvocacy.org/ 라는 사이트도 운영하고 있는데요. empathy advocacy라는 것이 우리말로는 적절한 표현을 찾기가 애매한데 비슷한 것을 찾아보면 "공감능력 전문가"(실제 이런 제목을 가진 과정이 운영되고 있긴 합니다)와 가까울 것 같습니다. 일단 세션의 목적은 뭔가 문제가 생겼을 때 이를 사용자에게 어떻게 전달하고 사용자가 행동하게 하도록 하는 것인가를 다루고 있습니다. 전반부에 뇌에 대해서 설명하고 뭔가 기술적인 내용보다는 좀 더 감성적인 영역을 다루고 있어서 쉽게 이해하기는.. WTD 프라하 2021 - 문서의 구조가 튼튼한지 살펴보기 Lana Brindley는 Timescale이라는 시계열 데이터 솔루션 기업의 테크니컬 라이터 겸 관리자입니다. Timescale이라고 해서 일정 관리 소프트웨어인가 싶었는데 잘못짚었네요. 세션 시작에 Bundjalung(한국어 표기는 분달롱) 이야기가 나옵니다. 올해는 호주 WTD 이벤트가 취소되어서 아마 그때 하려고 했던 이야기를 꺼낸 것이 아닌가 싶습니다. WTD 세션 중 해당 지역에서 나온 이들은 간혹 그 지역의 이슈나 하고 싶은 이야기를 하더라구요. 하여간 분달롱은 호주 원주민이라고 합니다. https://en.wikipedia.org/wiki/Bundjalung_people https://youtu.be/Gm-0IIvWLmE 세션 중간에 나온 표 중에 독자에 대한 정의가 인상적이었습니다. 보통.. WTD 프라하 2021 - 히치하이커를 위한 문서화 도구, 프로세스 가이드 Lukas Reussner는 2018년 대학을 졸업하고 Bosch.IO에서 테크니컬 라이터로 일하고 있습니다. 보쉬 자회사로 고객사의 IoT 프로젝트를 지원하는 조직이라고 합니다. 하드웨어 개발부터 비즈니스 모델 설계까지 다양한 분야의 서비스를 제공한다고 합니다. WTD 프라하 2021 첫 세션이었던 이번 발표는 간단한 개념부터 시작해서 QFD(Quality Function Deployment) 기반의 멋진 도구까지 공개해주고 있습니다. 세션 앞부분에서 요구사항의 분류나 문서 도구를 소개할 때까지만 해도 그냥 이렇게 소개만 하면 처음 문서화 작업을 시작하는 이들에게도 아니면 뭔가 현재 프로세스를 바꾸고자 하는 이들에게도 만족스럽지 못할 것 같았는데 QFD 이야기로 넘어가면서 시트에 간단한 체크를 통해 적.. 이전 1 ··· 8 9 10 11 12 13 다음
