테크니컬 라이팅
-
구글의 스타일 가이드테크니컬 라이팅 2019. 7. 23. 11:43
IBM, 마이크로소프트, 애플 모두가 스타일 가이드를 갖고 있다. 마이크로소프트의 것은 심지어 아마존에서 구매할 수 있다. https://www.amazon.com/Microsoft-Manual-Style-4th-Corporation/dp/0735648719/ref=sr_1_1?keywords=Microsoft+manual+of+style&qid=1563849667&s=gateway&sr=8-1 이 책이 2012 년에 출간되었는데, 그 뒤에도 한참 동안 구글 스타일 가이드는 찾기 어려웠다. 오늘 문득 이것이 떠올라 찾아봤다. https://developers.google.com/style/ 제목 Google Developer Documentation Style Guide이 암시하듯, 이 문서는 방대한 문..
-
넘다테크니컬 라이팅 2019. 5. 22. 12:14
"넘다"는 형태적으로 묘한 말이다. 의미상 타동사 같은데, 자동사로도 쓰이고 타동사로도 쓰인다. 그는 쉰 살이 넘었다. 기준 소득을 넘는 초과분에 대해서는 더욱 높은 세율을 적용해야 한다. "기준 소득을"은 어색하게 들리지 않고 "기준 소득이"로 바꾸어도 크게 어색하지 않다. 하지만 "쉰 살이"를 "쉰 살을"로 바꾸면 아주 부자연스럽다. 물리적 행위를 뜻할 때는 의심의 여지없이 의미적으로도 형태적으로도 타동사이다. 도둑이 담을 넘어 들어왔다. 여기서는 "담을"을 도저히 "담이"라고 바꿀 수 없다. 추상적 상태를 나타낼 때, "된다"처럼, 자동사로 쓰인다고 보아야 할까?
-
2015 Society for Technical Communication Summit테크니컬 라이팅 2019. 3. 7. 17:50
왜 Conference 대신 Summit이란 말을 쓸까? 미국인 동료에게 물어 보니, "멋져 보이려고." 아무튼 2015 서밋에서 다루어진 것들 가운데 주목할 만한 것들을 여기에 남긴다.Applying Users’ Mental Models to Information Design사람들이 예상하는 방식으로 제품이 작동할 때 그들이 그것을 성공적으로 사용할 수 있다. 제품이 설계된 방식에 대해 정확한 심리적 모델을 사용자들이 개발하는 것을 우리가 돕지 않는다면 우리는 사용자들이 스스로 심리적 모델을 개발하도록 방치하는 것이다. 가장 좋은 시작점은 사용자들이 무엇을 알고 싶어하는지 분석하고 그 다음에 사용자 질문들이 흘러가는 순서를 평가하는 것이다.Tutorial Pacing따라하기(튜토리얼)의 보조가 너무 빠..
-
평철테크니컬 라이팅 2019. 3. 7. 14:17
소재와 제조 방식에 따라 압연 강판, 도금 강판 등 여러 종류의 철판 또는 (강철로 만들어진) 강판이 있는가 보다. 두께에 따라 후판(6 mm 이상), 중판(1~6 mm), 박판(1 mm 이하)으로 나뉜다고 한다. 그런데 평철은 무엇일까? 강판을 잘라 만든, 말 그대로, 평평한 철이라는 뜻이라고 한다. 평철의 가장 흔한 용도가 계단 난간이다. "평철"은 재료 수준에서 사용되는 용어이다. 이것은 대체로 얇고 길며 무언가지를 지탱하기 위한 목적으로 사용되므로 "막대"로 옮기는 것이 적절하다. 최근에 한 프로젝트에서 내가 "고정 평철"을 "고정 막대"로 옮기었는데 의뢰인이 그것을 도로 "평철"로 고치라고 요구했다. 조금도 새삼스럽지 않다, 늘 겪는 일들 가운데 하나일 뿐.
-
카카오뱅크에서 이체하기테크니컬 라이팅 2019. 3. 4. 15:55
테크니컬 라이팅 금언 중에 "사용자가 스스로를 바보 같다고 느끼게 하지 말라"라는 말이 있다. 카카오뱅크에서 이체를 시도하다가 내가 바보가 되었다.대출한 천오백만 원을 아내에게 보내려고 했다. 늘 그랬듯이 카카오톡 친구에게 보내기를 이용하려 했다. 그런데 이체 한도가 백만 원에 불과하다. 내 이체 한도를 조회하니 일회 이체 한도는 천만 원, 일일 이체 한도는 오천만 원이다. 그보다 많은 금액을 보내려면 OTP가 필요하다. 나의 시도들은 거듭 실패했고 결국 이체 한도 증액을 요청했다. 신분 확인을 위해 신분증 촬영과 영상 통화라는 번잡한 절차를 거쳐야 했다.이체 한도를 늘린 뒤에 불필요한 짓을 했다는 것을 깨달았다. 그 이체 한도는 계좌번호로 보내기에 적용되는 것이었다. "백만 원 이상 보내려면 계좌번호로..
-
띄어쓰기테크니컬 라이팅 2018. 11. 29. 12:22
한글 맞춤법의 띄어쓰기 규정은 모호하고 일관적이지 않다.제46항단음절로 된 단어가 연이어 나타날 적에는 붙여 쓸 수 있다.제47항보조 용언은 띄어 씀을 원칙으로 하되, 경우에 따라 붙여 씀도 허용한다.제49항성명 이외의 고유 명사는 단어별로 띄어 씀을 원칙으로 하되, 단위별로 띄어 쓸 수 있다.제50항전문 용어는 단어별로 띄어 씀을 원칙으로 하되, 붙여 쓸 수 있다.이 조항들은 그다지 대수롭지 않고, 더 큰 문제는 띄어쓰기의 기본 원칙이 제시되어 있지 않다는 것이다. 예를 들자면, "봄비"는 한 낱말로 굳어진 것으로 간주되어 국어 대사전에 등재되어 있다. 하지만 46항을 적용하면 "봄비"를 한 단어로 보지 않아도 된다. 국립국어원은 띄어쓰기 기준을 형태에만 두는 것처럼 보인다.현재 표준 국어 대사전에서는..