본문 바로가기

테크니컬 라이팅

(433)
테크니컬 라이터가 동영상도 만들어야 하나요? "상황에 따라 그럴 수도 있다."라고 답할 수 있습니다. 전문 동영상 촬영팀과 편집팀이 있다면 그럴 필요는 없겠지만 조직에서 동영상을 필요로 하고 콘텐츠를 만들 수 있는 테크니컬 라이터뿐이라면 아마도 그럴 수 있을 겁니다. 물론 글쓰기와 영상 만들기는 다른 기술과 훈련이 필요한 분야이지만, 그나마 최선의 선택지라는 것이지요. 그리고 이미 테크니컬 라이터를 테크니컬 커뮤니케이터라고 부르는 시점부터 이런 변화에 익숙해져야 한다는 신호를 주기도 했구요. 자. 그럼 최근에 올라온 채용 공고를 살펴보죠. QueryPie라는 회사입니다. 창업 시에는 회사명은 체커(CHEQUER)였고 제품명이 QueryPie였는데 어느 시점에 회사명도 QueryPie로 바꾸었나 봅니다. 카카오 출신 황인서 대표가 창업한 회사이고 데..
맞춤법 검사기 비교 카카오 엔터프라이즈 기술 블로그에 올라온 예제로 확인해보았습니다. https://tech.kakaoenterprise.com/132 다음 맞춤법 검사기 네이버 맞춤법 다음 맞춤법 검사기와 비슷한데 "돼더라고요"를 띄어쓰기 오류로 체크하고 있습니다. 띄어쓰기 문제는 아니라서 정확한 체크는 아니었습니다. * 네이버 맞춤법 검사기는 따로 서비스를 제공하지 않고 "맞춤법" 등 키워드 검색 시 검색 결과 상단에 표시됩니다. 한국어 맞춤법/문법 검사기 "던지", "돼더라고요" 오류까지 잡아냈습니다. 아마 계속 업데이트가 되기 때문에 포털 검사기와 차이가 생기는 것 같습니다. 있다가 "있다가"라는 표현은 좀 애매합니다. 국립국어원 답변 중에 같은 의미로 보는 답변도 있습니다. 네이버 사전에서는 "이따"만 표준어로 삼..
논문 살펴보기 - 전자 제품 사용 설명서의 어휘 사용 양상 (남경완) 이전 글과 연결되는 논문입니다. 논문 작성 과정은 좀 다른데요. 이전 논문은 기업 내 매뉴얼 작성자 워크숍을 통해 얻은 내용을 정리한 것이라면 이번 논문은 14종의 매뉴얼을 선정하고 9개월 동안 3명의 감수자가 이를 감수하고 매뉴얼 작성팀과 세미나를 통해 내용을 정리한 것입니다. 아마 감수 과정의 리포트는 해당 기업에 제출되었을 것이고 이 논문에서는 그중 몇 가지 사례를 정리한 것이 아닌가 싶습니다. 2022.01.20 - [테크니컬 라이팅] - 논문 살펴보기 - 전자 제품 사용 설명서 텍스트 분석 (남경완) 논문은 KCI에서 원문을 내려받을 수 있습니다. https://www.kci.go.kr/kciportal/ci/sereArticleSearch/ciSereArtiView.kci?sereArticle..
논문 살펴보기 - 전자 제품 사용 설명서 텍스트 분석 (남경완) kakaoenterprise 기술 블로그에 올라온 글 중에서 "언어학 관점에서의 기술문서 가독성 향상 전략"이라는 글이 있었는데요. 여기 참고 문헌으로 있던 논문 중 하나입니다. 네이버 학술정보에서는 무료로 원문을 볼 수 있는 것처럼 나와있지만 실제 한국 학술지 인용색인(KCI) 사이트에서는 일부 미리보기만 지원합니다(회원 등급에 따라 다를 수 있겠지만 일반 회원인 경우에는 그렇습니다. KCI에서는 원문이 무료로 공개된 문서와 그렇지 않은 것이 구분되어 있습니다). https://tech.kakaoenterprise.com/100 원문을 무료로 보려면 "한국어문학국제학술포럼" 사이트에서 파일을 받을 수 있습니다. 사이트 메뉴에서 [e-Journal > 학술지 > 2018 > 제42권]에서 확인할 수 있습..
맞춤과 정렬 "정렬"은 "가지런하게 줄지어 늘어섬. 또는 그렇게 늘어서게 함"의 의미를 가지고 있습니다. 추가로 정보통신용어사전에서는 "문서를 작성할 때 문자열을 오른쪽, 중앙, 왼쪽 가운데 어느 한쪽을 기준으로 하여 맞추는 것. 예를 들어 문자열의 기준을 왼쪽으로 하면 모든 행에 나타나는 정보의 시작점이 같은 열에 나란히 있게 된다. 대부분의 문서 처리기 프로그램에서는 정렬 메뉴를 제공하고 있다"라는 풀이를 더하고 있습니다. 하지만 "맞춤"은 사전적 의미에서 글자의 배치 기준을 설정하는 풀이는 없습니다. 문서 도구를 보면 일부는 "정렬"을 일부는 "맞춤"을 사용합니다. 어떤 도구들이 어떤 용어를 사용하는지 살펴봅시다. 맞춤 구글문서 한국어는 모두 "맞춤"이라는 표현을 사용합니다. 하지만 영어로 표시를 변경해보면 a..
개조식 문장은 써도 되는건가요? 글쓰기 관련 서적이나 글을 보면 "개조식 문장"은 풀어쓴 글보다 직관적이고 이해하기 쉽다고 설명하고 있습니다. 하지만 이걸 잘못 이해해서 기계적으로 반영하다 보면 잘못된 문장을 작성할 수도 있습니다. * 개발자의 글쓰기 (김철수) ...여러 가지 요약 방법 중에서 서술식 문장을 개조식 문장으로 바꾸는 방법을 쓰면 내용이 자연스럽게 축약되고 의미는 더 분명해진다. 개조식 문장으로 만들려면 다음과 같이 불필요한 부사나 형용사, 조사나 어미를 없애고, 정확하고 적절한 단어로 대체하면 된다... * 개발자들을 위한 테크니컬 라이팅 10계명 https://tech.kakaoenterprise.com/110 ...테이블이나 간단한 안내 항목 등에서 '~다'의 종결 어미 대신 명사나 용언의 명사형(예: ~임, ~함)..
2022년 1월 테크니컬 라이팅 이런 저런 소식 1월 3일 카카오 엔터프라이즈 테크니컬 라이터 팀에서는 꾸준히 테크니컬 라이팅에 도움이 될 수 있는 글을 공유하고 있습니다. 이번에는 트러블슈팅에 관련된 내용입니다. 국내에서는 "문제 해결"로 번역해 사용하고 있습니다. 카카오 같은 경우도 "카카오 로그인 개발자 문서"에서는 "문제 해결"로 메뉴명을 표시하고 있습니다(하지만 위키피디아에서는 "트러블슈팅"과 "문제 해결" 문서가 따로 있습니다. "트러블슈팅"을 "문제 해결"의 일종으로 구분하고 있네요). https://developers.kakao.com/docs/latest/ko/kakaologin/trouble-shooting "...일반적으로 Troubleshooting 가이드는 오류 상황을 나타내는 오류 코드 혹은 오류 메시지, 문제 원인 및 증상,..
2021년 11월 테크니컬 라이팅 이런 저런 소식 11월 3일 올해 카카오 컨퍼런스 세션 중 글쓰기에 관한 세션이 있는지 찾아보았습니다. 테크니컬 라이터를 위한 글쓰기는 아니지만 오히려 더 어려운 사용자를 위한 글쓰기 가이드를 만들어낸 경험을 공유하는 세션이더군요(11월 16일 오전에 열리는 세션입니다). https://if.kakao.com/session/66 찾아보니 지난 8월에 카카오 메이커스 브런치를 통해 가이드에 대한 이야기를 공유하고 있었네요. 아마 브런치에 있는 내용이 세션에 담기지 않을까 싶습니다. 브런치 본문에 가이드 문서 PDF 파일을 내려받을 수 있는 링크가 있습니다. https://brunch.co.kr/@makerswithkakao/28 11월 5일 냉장고 소리 이해하기라는 독특한 콘텐츠입니다. 실제 냉장고 소리를 들어볼 수 있고..

반응형