분류 전체보기
-
나의 스타일 가이드테크니컬 라이팅 2021. 5. 4. 14:57
까맣게 잊고 있었는데, 오늘 우연히 이 파일을 발견했다. 오래 전에 내가 애플 스타일 가이드 같은 것을 만들려 시도했었다. 여러 명의 테크니컬 라이터가 함께 일하는 네이버 같은 곳에서는 그런 스타일 가이드가 필요할 것이다. 애플의 매뉴얼들은 그런 점에서 본받을 만하다. 마치 모든 문서들이 한 사람이 만든 것처럼 보인다. 표지에 "March 16, 2018"이 표시되어 있지만, 그것은 이 파일이 레이텍으로 컴파일된 날짜를 가리키는 것이고, 실제로는 내용의 대부분을 2012년에 작성했던 것으로 기억한다. 잠시 훑어보니, 최근 2년 동안 영어로 작성할 일이 생기지 않았지만, 여전히 내가 지키는 규칙들도 있고, 더 이상 중시하지 않는 것들도 있다. 이 순진한 시도를 포기했던 이유가 힘에 부쳤기 때문만은 아니었다..
-
물리적 행위와 심리적 행위테크니컬 라이팅 2021. 5. 3. 18:06
카카오엔터프라이즈의 언어학 관점에서의 기술문서 가독성 향상 전략(tech.kakaoenterprise.com/100)이라는 글을 흥미롭게 읽었다. 내용이 흥미롭다기보다 접근 방식이 특이해 보인다. "어휘 위계"라든가 "복합 명제" 같은 개념들이 테크니컬 라이팅을 난해한 것으로 보이게 하지 않을까 싶다. 이 글에 대해 몇 가지를 짚어보고자 한다. 무료 요금제를 사용하는 경우에는 일부 API 호출이 통제됩니다. 이 예시에서 "통제"가 "허용하지 않음"과 "조종함"을 (애매하게) 의미할 수 있기 때문에, "불가능합니다"로 교체하는 것이 더 낫다고 한다. 올바른 지적이지만 저 문장을 잘못 이해할 가능성은 그다지 높지 않다고 본다. 우리가 항상 달리 해석될 여지가 없도록 기계적으로 완벽한 문장으로 표현을 하는 건..
-
KTCA와 TCN테크니컬 라이팅 2021. 4. 30. 11:43
2003년인가, techwriters라는 다음 카페를 통해 가진 첫 모임에 열 명 가량 모였다. 이 모임이 TCN(Technical Communicator Network)이 만들어지는 계기의 하나라고 볼 수 있다. 임재춘을 비롯한 몇몇 사람들이 간헐적으로 모임을 갖다가 2004년에 한국TC협회(Korea Technical Communication Association)를 설립했고, 2006년에 사단법인으로 인가를 받았다. KTCA는 주로 문서화 사업자들로 이루어진 단체였고, TCN 회원들은 대개 고용된 테크니컬 라이터들이었다. TCN은 그 뒤 몇 해 동안 한 해에 한두 차례 세미나를 열었다. 당시에는 기업들이 외부 인사들에게 강연을 의뢰하는 일이 흔했다. 정부가 비용을 지원하는 단기 교육도 많았다. (내..
-
TV를 벽에 설치하기과학적이거나 기술적인 2021. 4. 28. 16:01
아들이 새로 구매한 플레이스테이션 5 전용으로 사용할 TV로 43인치 리퍼 (refurbished) TV를 골랐다. 설치는 구매자가 해야 한다. 브래킷 상자에 인쇄된 설명을 보니 벽에 구멍 4 개만 뚫으면 된다. 전동 드릴을 이용하여 구멍 하나를 예상보다 어렵지 않게 뚫었다. 그런데 칼블럭이 들어가지 않는다. 영어로 wall plug 또는 anchor인 칼블럭이, 위키백과에 따르면, 일본 상품명 カールプラグ(Carl plug)에서 온 말이라고 하는데, 최초 발명자의 상품명인 Rawlplug를 모방하여 지은 이름인 것 같다. 마음에 들지 않는 명칭이지만 콘센트처럼 바꾸기가 어려울 것이다. 브래킷에 딸려온 칼블럭의 굵기에 맞게 구멍을 뚫으려면 지름 10 mm의 드릴 비트를 사용해야 했는데, 내가 가진 가장 ..
-
직함과 직인 이미지를 겹치기TeX과 친구들 2021. 4. 28. 14:36
최근에 KTUG에 올라온 질문의 취지가 직함과 직인 이미지를 겹쳐 놓으려는 것으로 보인다. \documentclass{article} \usepackage{kotex} \usepackage{graphicx} \usepackage{transparent} \ExplSyntaxOn \box_new:N \l_stamp_box \NewDocumentCommand \SetStamp { m } { \hbox_set:Nn \l_stamp_box { \smash{\includegraphics{#1}} } } \NewDocumentCommand \stamp { O{1ex} m } { \if_mode_vertical: \mode_leave_vertical: \fi: \hbox_overlap_right:n { \box_mov..
-
변기 부속 교체하기과학적이거나 기술적인 2021. 4. 26. 08:48
물내림 레버를 누르면 수위가 그대로인 채 물이 들어오는 만큼 나가는 듯했다. 휴지가 물에 떠서 같이 내려가지 않았다. 그래서 레버를 누르면서 물을 한 바가지 붓거나 화장지를 휴지통에 버려야 했다. 아파트가 오래된 탓으로만 여겼다. 나는 유튜브에서 공구에 관한 영상을 즐겨본다. 부구의 높이를 바꾸어 수조의 수량을 조절하는 영상을 보았다. 구식의 전면 레버를 포함하는 부속 세트를 주문하였다. 한 달 뒤에 통영에 내려갔다. 집에 있던 만능 렌치로 기존 부속들을 제거할 수 없다는 것을 깨달았다. 철물점에 가서 내가 무엇을 하려는지 주인에게 말했다. 그녀가 두 가지 렌치를 보여주었다. 이때까지도 나는 수조를 분리해야 부속들을 교체할 수 있다는 것을 알지 못했다. 위 그림에서 왼쪽 렌치는 튜브와 물 마개를 분리하기..
-
직업으로서 테크니컬 라이터테크니컬 라이팅 2021. 4. 21. 17:07
내가 테크니컬 라이터로서 경력을 시작할 무렵부터 그 뒤로 수 년 동안 테크니컬 라이터가 유망한 직종에 포함되었다. 아마도 그렇게 예견한 사람들은 미국에서 GDP 같은 지표가 어느 수준에 도달했을 때 테크니컬 라이팅에 대한 수요가 크게 증가했다는 따위의 분석에 의지했을 것이다. 나는 그것이 거대 기업 하나 때문에 평균 매출이 왜곡되는 것과 같은 착각이었을지도 모른다고 생각한다. 테크니컬 라이터에 대한 수요와 보수가 미국에서만 유독 높은 것이 아닐까? 테크니컬 라이터를 찾는 일자리가 여전히 드물다. 내가 생각하기에 가장 근본적인 이유가 우리 문화가 글을 중시하지 않는 데에 있다. 캐나다 친구가 말하길, 전통적인 영어 사용 국가에서 글을 잘 쓰는 사람은 존경받고 그렇지 않은 사람들은 멸시당하는데, 그 정도가 ..
-
구멍가게, 오늘도 문 열었습니다책을 읽거나 글을 쓰거나 2021. 4. 21. 12:29
지난 가을인가, 봄날의책방을 예고 없이 방문한 지인들이 묵을 곳이 없어서 우리의 봉평아파트를 빌릴 수 있는지 대표가 서로의 지인을 통해 아내에게 물었다. 비어있는 집이라 거절할 이유가 없었다. 그 손님들이 감사의 인사로 봄날의책방에서 산 책 몇 권을 남겨두었다. 아내가 일하는 출판사에서는 새 책이 나올 때마다 다른 팀들에게 나눠준다고 한다. 아내가 두어 달에 한 번씩 가져오는 책들이 쌓여 두 벽면을 가득 채웠다. 아내가 책 몇 권을 챙겨서 그 손님들이 다녀간 두 주 뒤에 통영에 내려갔다. 봄날의책방을 찾아가 그 책을 선물했다. 초면이어서 나눌 얘기가 없었다. 인사를 하고 나오는데 그가 답례로 그림 엽서 두 장을 건넸다. 내가 그 그림들을 보며 아주 즐거워하자, 아내가 그 책방에 다시 들어가 "구멍가게, ..