테크니컬 라이팅
-
차 문 손잡이테크니컬 라이팅 2023. 2. 7. 09:32
저것을 interior door handle이라고 부른단다. 바깥 손잡이를 잡아당기면 손잡이가 당겨지면서 문이 열리지만, 안에서 문을 열려면 손잡이를 당기고 문을 밀어야 하니, 손잡이라 일컫기에 부족한 듯하지만, 잠금을 푸는 것은 매한가지이니 달리 부를 이유가 없다. 그렇다면, 저 손잡이와 구분하여, 안에서 문을 닫기 위해 잡아당기는 것은 무엇이라 불러야 할까? 그에 대한 통일된 명칭을 찾기 어려운데, door panel handle, door trim handle, 또는 door armrest handle이라 부르기도 하지만, 가장 흔한 이름이 door pull handle인 것 같다.
-
문서 기획테크니컬 라이팅 2023. 1. 25. 13:34
오늘 문득 나와 내 동료들이 하는 일 대부분이 엉망진창에 가깝다는 자괴감이 들었다. 왜 그럴까? 나는 TW에게 PM 능력이 아주 중요하다고 생각해왔지만, 그보다 더 중요한 게 기획이라는 생각이 들었다. 오래 전에 사흘짜리 PM 교육을 수강한 적이 있는데, 그것에 기획에 관한 것은 포함되어 있지 않았던 것 같다.누가 프로젝트 기획을 하는가? PM이? 또는 이해당사자들의 합의에 의해? 문서 개발에서는 목차를 뽑는 것쯤을 기획이라고 여기지만, 무엇에 근거하여 목차를 결정하는가? 문서가 무슨 역할을 해야 하는지, 그래서 어떤 정보가 담겨야 하는지 한 번도 논의의 장을 가져본 적이 없다. 앞으로도 그럴 기회가 생기리라 기대하지 않는다. 문서 기획에서 무엇들을 고려해야 하는지는 인터넷에서 쉽게 찾을 수 있다. In..
-
terminal, console, shell, command-line테크니컬 라이팅 2022. 9. 15. 10:42
Terminal : A terminal is a text input and output environment. A terminal window, also known as a terminal emulator, is a text-only window that emulates a console in a graphical user interface (GUI). A terminal is a program that allows you to run a shell. Console : A console is a physical terminal; an instrument panel containing computer controls. For example, Famicom, Xbox, PlayStation, Nintendo..
-
'뒤에' 또는 '후에'테크니컬 라이팅 2022. 6. 20. 15:09
구글을 이용하여 비교해 보면, "후에"가 "뒤에"보다 훨씬 더 많이 쓰인다. 이를테면, "한 시간 후에"가 들어간 문장이 "한 시간 뒤에"보다 세 배나 많이 검색된다. 의미상의 차이나 용법상의 차이가 있다고 말하기 어렵다. 왜 그럴까? 조사가 붙는 경우에 한정하자면, '앞'은 front, future, 그리고 공간적 before의 뜻으로 사용된다. '앞서'가 시간적 before를 나타내지만, 그것은 '앞'에 조사가 붙은 말이 아니고, 독립적인 부사어이다. '뒤'는 back, rear, after, behind의 뜻으로 사용된다. '전'은 오로지 시간적 before의 뜻으로만 사용되는 것으로 보인다. '후' 역시 오로지 after의 뜻으로만 사용되는 것으로 보인다. '뒤에'를 쓰지 않고 '후에'를 써서 얻..
-
Single-Source Publishing에 대하여테크니컬 라이팅 2022. 6. 16. 14:38
싱글 소스 퍼블리싱을 두 가지로 볼 수 있겠다. 하나는 두 가지 이상의 포맷으로 문서를 만드는 것이다. PDF와 HTML. ePub은 HTML을 압축한 것이니, HTML을 얻을 수 있다면 ePub을 만드는 것도 어렵지 않을 것이다. PDF와 HTML을 생성하는 솔루션들은 여럿 있다. 스핑크스(Sphinx), 아스키독(AsciiDoc), 쓰리래빗츠(3Rabbits), 그리고 내가 알지 못하는 다른 많은 것들이 있을 것이다. 간단한 문서만 만들자면 주피터 노트북(Jupyter Notebook)과 타이포라(typora)도 선택지에 넣을 수 있다. 어느 솔루션을 사용하든 크고 작은 문제들에 맞닥뜨리게 될 텐데, 대부분 "jpg 이미지만 사용한다"거나 "색인은 만들지 않는다" 따위의 정책을 취하여 극복할 수 있을..
-
자동차 설명서 파일 합치기테크니컬 라이팅 2022. 6. 2. 14:55
자동차회사들은 설명서 파일들을 장 단위로 쪼개어 웹사이트에 게재한다. 왜 그렇게 하는지 모르겠다. PDF 파일에 북마크는 고사하고 하이퍼링크도 없다. 페이지 번호는 장마다 새로 시작한다. 설명문들이 대체로 장황하거나, 애매하거나, 모호하여 쉽게 이해되지 않는다. 경사로 밀림 방지 기능은 경사가 심한 언덕길에서 정차 후 출발 시 일시적으로 브레이크가 작동하여 차가 뒤로 밀리는 것을 방지합니다. 이 기능은 약 2초간 작동되나 가속 페달을 밟아 차가 출발하면 자동으로 해제됩니다. 이 기능은 운전자의 능동적인 조작을 요구하는 것이 아니어서, 다음과 같이 간단히 소개하는 것만으로 충분하다. 오르막길에서 출발하기 위해 가속 페달을 밟으면, 브레이크가 잠깐 작동하여 차가 뒤로 구르는 것을 방지합니다. 또는 더 짧게,..
-
모든 것들을 가리킬 때 the테크니컬 라이팅 2022. 5. 19. 10:58
"고래는 포유류이다"를 구글 번역기는 "Whales are mammals"로 옮긴다. 1) Whales are mammals. 2) The whale is a mammal. 3) A whale is a mammal. 구글을 검색해 보면 실제로 "Whales are"가 가장 많이 보이고, "The whale is"가 그 다음이다. 그런데 "피아노는 악기이다"를 뜻하는 표현들 중 가장 많이 보이는 것이, 위와 달리, "The piano is"이다. 1) The piano is an instrument. 2) A piano is an instrument. 3) Pianos are instuments. 고래가 생물이고, 피아노가 인간이 만든 기구라는 데에 차이가 있는 게 아닐까 싶다. 그리고 전체를 가리키기 위..
-
등록과 register테크니컬 라이팅 2022. 5. 10. 09:50
등록: 허가나 인정을 받기 위해 단체나 기간 따위의 문서에 이름을 올림. 출생, 입학, 졸업, 입대, 결혼, 사망, 주택, 자동차 등, 공문서에 기재하는 것이 등록이다. register가 등록에 딱 들어맞는다. register: 1) a formal or official recording of items, names, or actions. 2) enter or record on an official list or directory 등록과 register 모두 공적 (official) 문서를 전제로 한다. 스마트폰이 등장하면서 "등록"이란 말을 "기입"의 의미로 사용하게 된 것 같다. 그 전에는 일상 생활에서 "등록"이란 표현을 쓸 일이 별로 없었다. 이제까지 앱에 표시된 "등록" 버튼에 별 의문을 품지 ..