열이아빠의 어쨌거나 저쨌거나

지난 3월 일본 라인에서 테크니컬 라이팅 밋업이라는 영상을 공개했습니다. 라이브로 진행된 밋업을 정리해서 유튜브에 공개했더군요. 매달 1회 정도 진행할 예정이라고 합니다. 3월에 공개한 영상은 2개의 세션으로 진행됐는데 첫 번째 세션은 개발자를 위한 글쓰기 팁이고 두 번째 세션은 테크니컬 라이터가 하는 일에 대한 소개입니다. 두 번째 세션에 일본 라인에서 어떤 식으로 일을 하는지 간단하게 소개하고 있어 그 내용을 간략하게 소개합니다. 1. 테크니컬 라이터는 무슨 일을 하나요? 어떤 글을 쓰나요? 주로 하는 일은 외부에 공개되는 개발자 문서를 작성합니다. 예를 들어 라인 로그인 기능을 내 사이트에서 어떻게 구현해야 하는지 알고 싶다면 라인 개발자 사이트에서 관련 가이드와 API 문서를 찾을 수 있습니다. ..

테크니컬 라이팅 2021. 4. 13. 12:23

문서 내에서 예를 들어 설명하는 코드나 이미지를 "예제"라고 써놓았더군요. 예전부터 그렇게 쓰고 있었고 읽었을 때 뭔가 이상한 느낌이 없어서 계속 쓰고 있었는데, 생각해보니 "예제(例題)"는 한자에서 보듯 "보기로 들어주는 연습 문제"라는 의미입니다. 보여지는 코드가 문제 유형이라면 괜찮겠지만 보통은 예시로서 보여주는 것이기 때문에 "예제"는 적합한 표현이 아닌 것 같습니다. "예시(例示)"가 좀 더 적절한 표현이겠네요. 영어 사전만 봐도 "예제"는 "exercise, practice problem"이고 "예시"는 "example, illustration"입니다. 보통 문서 내에서는 "Example"의 의미로 사용하기 때문에 "예시"가 맞겠죠. 그냥 "예"라고 표현해도 되고요.

테크니컬 라이팅 2021. 4. 12. 16:12

'개발자를 위한 글쓰기 가이드 / 유영경 / 로드북'에서 참고자료(도서) 목록을 정리했습니다. 이번 글에서는 번역서 또는 국내서를 먼저 소개합니다. 1. 바바라 민토, 논리의 기술 국내에서는 2005년, 2019년 두 차례 출판됐습니다. 국내에 나온 책은 1996년판을 바탕으로 번역했다고 하는데 원서 최신판은 2010년판입니다. www.barbaraminto.com/textbook.html 사이트를 보면 기존 책(The Pyramid Principle: Logic in Writing and Thinking)을 새로운 책(The Minto Pyramid Principle: Logic in Writing, Thinking and Problem Solving)이 대체한다고 명시되어 있는데 뭔가 저작권 관련 분..

테크니컬 라이팅 2021. 4. 8. 12:26

한 줄 요약 "차출"과 "착출"은 같은 의미는 아닙니다. 하지만 "착출"이 없는 단어도 아닙니다. 메신저로 대화를 하다가 "착출 되었답니다"라는 표현을 쓰고 나서 뭔가 느낌이 이상해서 사전을 찾아보니 "착출"이라는 단어는 없고 "차출"이 맞는 표현이라고 합니다. 다행스럽게도 신문기사에서도 "착출"이라는 표현을 간혹 쓰는 걸 보면 많이 틀리는 표현인가 봅니다. 그런데 국립국어원 답변이 좀 애매합니다. 착출이 맞는지 물어보는 질문에 한자 표현일 수도 있다는 답변을 남기더군요. 보통 오타라고 판단되면 "차출의 오타입니다"라는 식으로 답변을 달아주는데 말이죠. 그래서 찾아보았습니다. 국어사전뿐 아니라 한자사전에서도 "착출"은 보이지 않습니다. 일본어 사전에는 표현이 있긴 한데, 좀 다른 의미인 듯하네요. 하지만..

테크니컬 라이팅 2021. 4. 7. 16:35

'T맵 데이터 무과금(제로데이팅) 혜택 종료' 소식이 전해지면서 말이 많은가 봅니다. SKT 블로그에서 공식적으로 팩트 체크 글을 올렸습니다. www.sktinsight.com/130077 “T맵 유료화? 사실이 아니에요” 팩트를 알려드립니다 | SKT Insight 최근 운전자들 사이에서 화제가 된 소식이 있습니다. ‘T맵 데이터 무과금(제로데이팅) 혜택 종료’ 소식인데요. 관련하여 T맵이 유료화된다는 오해가 발생하기도 했습니다. 많은 운전자가 놀랐 www.sktinsight.com 내용 중 팩트와 살짝 다른 점이 있어서 언급해보고자 합니다. 이번 소식을 정확히 설명하자면, ‘SKT 고객에게만 주어졌던 T맵 데이터 무과금 혜택을 종료한다’입니다. 잘못 생각하면 SKT 고객은 모두 무과금 혜택을 받았던 ..

그냥 블로그 2021. 4. 1. 16:17

'syntax'를 '구문'으로 번역하는 것이 뭔가 어색하다는 느낌이 들어서 그 의미를 찾아보았습니다. 그러고 보니 아무 의심 없이 '구문'이라는 표현을 사용하고 있었더라구요. 네이버 국어사전 (표준국어대사전) 2가지 의미를 보여줍니다. 일반적인 글에서 사용하는 의미와 컴퓨터 분야에 해당하는 의미가 따로 설명되고 있습니다. - 글의 짜임. - 컴퓨터에서, 원시 언어의 문장을 올바르게 구성하기 위한 규칙. 자연어의 문법에 해당한다. 두 번째 설명이 좀 애매하네요. '자연어의 문법에 해당한다'라니요. 근데 왜 문법이 아니라 구문이라고 하는 거죠. 정보통신용어사전 3가지 의미를 보여줍니다. 뭐 그렇지만 해석의 차이일 뿐 내용은 크게 다르지 않습니다. - 문자들의 의미 해석을 하고 사용하는 방법과는 무관한 문자들..

테크니컬 라이팅 2021. 4. 1. 10:34

한줄요약 PASS 앱은 설치할 수 있지만 실행할 수 없다. 단말기 모델에 따라 간혹 되는 경우도 있지만 자급제 폰은 안된다. 실명 인증하면 PASS 앱을 깔라고 계속 안내가 나오는데 귀찮기도 하고 뭔가 시키는 건 하기 싫어서 설치를 하지 않고 있었습니다. 그러다가 디지털 면허증을 발급받을 수 있는데 PASS 앱이 필요하다는 이야기를 듣고 어떤 건가 궁금해 PASS 앱을 설치했습니다. PASS 앱이 통신사별로 따로 있다는 것도 처음 알았네요. 저는 LGT망을 사용하니깐 'PASS by U+ 연말정산, 빠르게 PASS!'앱을 설치합니다. 설치 후 앱을 실행하면 무슨 유심 체크 앱을 같이 설치합니다. 그리고 다시 실행하면 뭐가 안된다고 하네요. 아래에 보면 "서비스 이용을 위한 통신사 권한을 획득 중입니다"라..

그냥 블로그 2021. 3. 26. 13:00

한줄요약 한국만의 문제는 아니지만, 북미나 유럽 쪽은 저녁, 새벽 시간대라 큰 영향이 없었다는... 23일 구글 웹뷰(Android 시스템 WebView) 버그 때문에 일부 앱 실행이 되지 않거나 비정상 종료되는 오류가 있었다고 합니다. 구글 코리아에서도 3차례 블로그에서 관련 오류에 대한 안내문을 내보냈습니다. 블로그에는 글을 게시한 시간이 표시되지 않는데, 블로그 포스팅을 발행하면서 페이스북에도 같이 게시했다고 가정하면 최초 글을 올린 시간은 23일 오후 2시 47분입니다. 그리고 오후 5시 2분에 문제가 해소되었다는 글을 올렸고 24일 오후 3시에 업데이트 안내에 대한 게시글을 다시 올렸습니다. * 구글 블로그에 올라온 다른 게시글을 보면 HTML 파일명은 게시물 제목을 영문으로 작성하는데 이번에는..

그냥 블로그 2021. 3. 25. 10:18