Kakao Enterprise

시작하며 안녕하세요. 카카오엔터프라이즈 테크니컬라이팅팀의 Crystal(김유리)과 Sandy(차신영)입니다. 이전 포스팅에서 목차의 중요성과 기술 문서 작성 5단계 등 테크니컬라이팅 기법을 설명드렸는데요. 오늘은 그 연장선으로 기술문서 본문 첫 페이지에 등장하는 개요에 대해 살펴보고, 개요의 역할과 작성 방법 등을 알아보겠습니다. 누군가를 처음 만날 때 듣게 되는 자기소개처럼 기술문서의 도입부에 위치한 ‘개요’는 해당 문서를 처음 펼쳐본 독자에게 전하는 문서의 자기소개라고 할 수 있습니다. 즉, 개요를 통해 독자는 해당 문서가 어떤 내용인지 대략적으로 파악할 수 있는데요. 훌륭한 1분의 자기소개가 면접의 당락을 가를 수 있듯이, 잘 정돈된 개요는 독자와 마주한 문서의 첫인상을 결정하는 동시에 해당 문서의..

시작하며 안녕하세요. 카카오엔터프라이즈 음성처리팀의 카를로스와 덴젤입니다. 헤이카카오나 카카오미니 스피커를 사용하고 있는 분들이라면 하루에도 몇 번씩 '헤이 카카오'라는 호출 명령어를 부르고 계시죠? 카카오미니는 2017년 출시 이후 사용자가 "헤이카카오~"라고 발화 시 서비스를 이용할 수 있도록 설계되었습니다. 하지만 카카오미니의 출시 이후 끊임없이 들어오는 요구사항이 하나 있었습니다. 바로 호출 명령어인 ‘헤이카카오’를 다르게 부르고 싶다는 것이었는데요. 구체적인 요구사항을 공유해 드리자면 “저는 ’헤이카카오’ 말고 ‘자비스’(영화 아이언맨에 나오는 인공지능 비서의 이름)라고 부르고 싶어요”, “혹시 해리포터에 나오는 마법주문으로 부르는 방법은 없나요?” 등이었죠. 요구사항들은 조금씩 달랐지만 포인트..

시작하며 안녕하세요. 카카오엔터프라이즈 테크니컬라이팅팀의 Crystal(김유리)과 Sandy(차신영)입니다. 그 동안 테크니컬커뮤니케이션 팀에서는 테크니컬 라이팅 4대 원칙과 언어학 관점에서 기술문서 가독성 향상 전략 등 테크니컬 라이팅과 관련한 정석적인 주제를 다뤘었는데요. 며칠 전 개발자 한 분께서 "테크니컬 라이팅 교육을 받고 싶은데 시간은 없고.. 어떻게 하면 기술 문서를 잘 쓸 수 있을까요? 혹시 간단한 팁이 있을까요?" 라는 질문을 주셨습니다. 생각해보면 개발자들이 많은 시간을 들여 테크니컬 라이팅을 심도있게 공부하기는 현실상 쉽지 않은 게 사실인데요. 그래서 오늘은 수 많은 테크니컬 라이팅의 이론과 팁 중에서도 기술문서 작성에 관심이 있으신 개발자 분들이라면 꼭 알아야 할 10가지 팁을 간추..

시작하며 안녕하세요. 카카오엔터프라이즈 워크엔진셀에서 프론트엔드 개발을 담당하고 있는 데니스입니다. 저는 이번에 신규 프로젝트의 FE (Front-end) 개발을 혼자 진행하게 되었습니다. 혼자 개발을 하다 보면 자칫 외로운 싸움이 될 수 있는데, 혼자 개발하면서 고민한 부분들을 이렇게 정리하고 공유하면 재미있을 것 같다는 생각이 들어서 포스팅을 작성하게 되었습니다. 앞으로 제가 진행하고 있는 신규 프로젝트 개발 과정을 차례대로 소개할까 합니다. 혼자 프로젝트를 진행하면 기술 스택이나 여러 가지 컨벤션을 마음대로 정할 수 있다는 장점과 자유가 있지만, 이 프로젝트를 평생 혼자서만 개발하고 운영할 것은 아니기에 제가 선택한 것에 대한 명확한 이유가 있어야 하고 합리적인 기술 스택과 컨벤션을 정해야 한다고 ..

시작하며 안녕하세요. 카카오엔터프라이즈 테크니컬라이팅팀의 Crystal(김유리)과 Sandy(차신영)입니다. 이번 테크니컬 라이팅 포스팅에서는 목차(Table of Contents)라는 주제를 다뤄보려고 합니다. 얼마 전에 저희 테크니컬라이팅팀에서 “기술 문서 작업 단계에서 가장 중요한 하나를 꼽는다면?” 이라는 질문에 대해 의견을 나눈 적이 있었는데요. 저희 모두 목차 구성으로 의견 일치를 본 만큼, 테크니컬 라이팅 기법에서 목차는 정말 중요한 주제가 아닐 수 없습니다. 본론으로 들어가기 전에 여러분이 지금 서점에서 특정 주제에 대한 책을 구매하려 한다고 가정해 보겠습니다. 이 상황에서 여러분들은 책의 어떤 부분을 가장 먼저 살펴보시나요? 아마 대부분의 경우 “목차”일 것입니다. 해당 목차에서 특정 페..

어렸을 적 즐겨보던 만화 중 ‘날아라 슈퍼보드'라는 만화가 있었습니다. 그 만화에는 무슨 말을 해도 잘 알아듣지 못하는 ‘사오정'이라는 캐릭터가 등장하는데요. 사오정은 가는 귀를 먹어 귀의 주름을 걷고 이야기를 듣지 않으면 이야기를 엉뚱하게 알아들어 많은 해프닝을 만들어 내기도 했습니다. 이렇게 만화 속 사오정처럼 카카오 i도 가끔 명령을 완벽히 알아듣지 못하는 경우가 있죠. 저희는 카카오 i가 무슨 말을 해도 잘 알아들을 수 있도록 “사오정 프로젝트”를 진행했습니다. 만화 속 사오정은 말귀를 못 알아듣는 캐릭터로 등장하지만, 사오정 프로젝트에서의 사오정은 카카오 i 발화의 대부분을 차지하는 음악 재생 발화의 오류를 획기적으로 줄여주는 고마운 캐릭터임을 밝히며 글을 시작하도록 하겠습니다. #사오정 프로젝..

사람들은 왜 AI에게 화를 내는가? 안녕하세요. 지난번 카카오 i의 작고 소중한 힐링 포스팅에서 힐링 사운드에 대해 소개드렸던 AI 기획팀 레아라고 합니다. 이번 포스팅에서는 내부에서 ‘사오정’이라 칭하는 음성인식 개선 프로젝트에 대해 소개하고자 합니다. 여러분은 AI 스피커에게 화내본 경험이 있나요? 혹은 주변의 누군가가 AI와 대화 중 급발진 하는 모습을 목격한적 있나요? (제겐 너무 흔한 일입니다만...🙄) 헤이헤이! 거기 있어요? 대답 없는 너. 아니... 그거 말고! 동문서답 하는 너. 또 이해하기 어렵다고? 똑똑한거 맞니 너….😂 왜 기계에게 화를 내냐구요? 우리는 인간을 닮았다는 인공지능이 진짜 인간처럼 대화하길 기대합니다. 부르면 재깍 반응하고, 뻔한 품사쯤 생략해도 맥락을 이해하고, 살짝..

시작하며 안녕하세요. 카카오엔터프라이즈 테크니컬라이팅팀의 Crystal(김유리)과 Sandy(차신영)입니다. 오늘은 ‘기술문서 쉽게 쓰기 지침’이라는 주제로 포스팅을 해 보려고 하는데요. 먼저 기술문서의 한 단락을 살펴보도록 하겠습니다. 어떠신가요? 일단 ‘역시 기술문서라서 어렵네’라는 생각을 하시는 분들이 많으실 텐데요. 다행히도 위 문장은 이번 주제를 함축적으로 설명하기 위해 가상으로 작성해 본 예시입니다. 사실 한국어의 경우 과거부터 한자어를 다수 포함한 만연체 문장이 널리 쓰였고, 최근까지도 각종 문서에서 외국어 번역체가 무분별하게 사용되고 있는 현실에 비추어 볼 때, 한국어에는 아직도 비직관적인 언어 습관이 많이 쓰이고 있는 것 같습니다. 오히려 과거에는 만연체나 번역투 문장이 더 트렌디하게 보..

시작하며 안녕하세요. 여러분들은 AI 스피커에 대해 얼마나 친숙하신가요? 2019년 통계를 보면 우리나라 가구 수를 2,000만으로 봤을 때, 약 40%의 가구가 AI 스피커를 보유하고 있다고 하는데요. 이렇듯 이제 어디에서나 쉽게 AI 스피커를 접할 수 있고, AI 스피커를 통해 음악 감상, 택시 호출, 카톡 읽기, 메일 전송, 음식 배달 등을 하는 것이 전혀 어색하지 않은 시대가 되었습니다. 가끔 어린 아이들은 “헤이~카카오!”, “지니야~”, “오케이~구글"과 같이 각 AI 스피커에 해당하는 이름을 부르는 것이 익숙하다보니 주변에 있는 공기 청정기와 로봇 청소기의 이름은 무엇이냐고 묻고 자연스럽게 말을 걸어보기도 합니다. 그만큼 기기와 사람이 대화하는 것은 너무나 평범한 일상이 되었어요. 나는 AI..