테크니컬 라이팅/컨퍼런스 (178) 썸네일형 리스트형 WTD 베를린 2025 - If you build it, they will come 발표자는 Salto Systems의 테크니컬 라이터입니다. Salto Systems는 여러 회사를 인수하면서 제품군을 확장하고 있는데요. 이 과정에서 테크니컬 라이터는 분산된 기술 문서와 리소스를 하나의 통합된 플랫폼으로 재구성하는 요구를 받습니다. 그렇지 않으면 사용자는 문서를 찾기도 어렵고 같은 회사의 문서에서 다른 형식을 만나야 하니깐요. 이런 문제는 성장하는 회사는 대부분 가지고 있는 과제입니다. 어떤 과정을 통해 문제를 해결했는지 자세하게 언급하지는 않고 있습니다. 개발자 포털 사이트를 만들고 통합 검색 기능을 제공하고 하나의 플랫폼(Hugo) 아래에서 문서를 빌드할 수 있도록 통합하는 작업을 진행했습니다. 딱히 뭔가 새로운 팁을 이야기하는 것은 아니라서 현장 반응은 막 그렇게 호응하는 분위기는.. WTD 베를린 2025 - 소격효과와 기술문서 뜬금없이 3D 프린팅에 대한 이야기로 시작합니다. 뭔가 쭈욱 읽어주는데 "3D Printing: Rise of the Third Industrial Revolution(2014)"라는 책에 나온 이야기라고 합니다. 이때만 하더라도 얼마 지나지 않아 3D 프린터에서 출력된 피자를 먹을 수 있는 날이 올 것이라 예상했지만, 현실은 좀 다릅니다(물론 일부 분야에서는 3D 프린팅이 엄청난 기술로 자리 잡고 있지만 대중적인 확산은 아니라는 이야기입니다). "Computers as Theatre(1993, 2013)"은 "컴퓨터는 극장이다(커뮤네이션북스)"로 번역되어 있습니다. "인터페이스는 무대입니다. 프로그램은 스크립트(대본)이구요. 사용자들은 관객이면서 배우로서 허구에 몰입하며 믿음을 유지합니다"라는 표현은 .. AI The Docs 2024 - 이제는 개발자 솔루션 포털의 시대다 Kristof Van Tomme는 Pronovix의 CEO입니다. Pronovix의 주요 사업이 개발자 포털을 만드는 것인데, AI 시대에 더 이상 문서화나 개발자 포털이 필요한가에 대한 질문을 많이 받았다고 합니다. 발표자의 생각으로는 AI 시대에 문서화와 API는 그 중요성이 더 커진다는 겁니다. 중간에 이런저런 이야기가 있지만 결론적으로는 개발자 포털을 넘어서 개발자 솔루션 포털을 강조합니다. 개발자에게 단순히 정보를 제공하는 것이 아니라 사용자가 자동화된 통합 기능을 구축할 수 있는 일련의 솔루션을 제공하는 방식을 제시합니다. 그 예로 stripe의 최근 개발자 포털 사이트를 예로 듭니다. 예전에는 각 기능에 대한 API 문서가 강조되었는데, 지금은 특정 작업에 관련된 API, 문서 등을 통합적으.. AI The Docs 2024 - 코드 생성을 위한 OpenAPI 스펙 만들기 이번 세션은 문서화보다는 OpenAPI 스펙 관점에서 설명하는 내용이라 살짝 애매합니다. AI 보다는 코드 생성이 중요한 곳에서 OpenAPI 스펙을 어떻게 만들어야 하는지 설명하는 내용이라고 볼 수 있네요. - We don't have an OpenAPI spec The Problem: "We've put off creating a spec. We want to make one, but we aren't sure if we should generate it or hand-maintain it." The Solution: Pick one, or try both and see what sticks. Every org is different. OpenAPI 스펙을 유지하는 방법이 정해진 정답이 있는 것은 아.. AI The Docs 2024 - 아직까지는 콘텐츠가 중요하다 Nick Gomez는 Inkeep의 공동 창업자입니다. MIT 출신으로 마이크로소프트를 거쳐 2023년에 창업을 했습니다. 아마도 이번 행사에 참여한 것은 솔루션 홍보를 위한 목적이겠지만, 세션 내내 제품 이야기를 할 수는 없으니 효과적인 RAG 구성을 위한 팁을 제시합니다. - Hierarchy is important 이건 모든 이들이 강조하는 부분입니다. 적절한 헤더를 설정하고 계층적인 구조를 만들어야 합니다. 그리고 콘텐츠의 형태도 주제>질문>응답의 형태 또는 FAQ 형식으로 작성되어야 합니다. 이런 콘텐츠 형태는 요즘 자주 언급되긴 하는데 기술이 발전하면 필요 없다는 이야기가 나올 수도 있습니다(개인적으로는 특정한 정답을 가지고 있는 구조라면 굳이 LLM을 사용하는 것이 효과적일까 싶기도 하구요).. AI The Docs 2024 - 우리 조직의 문서 시스템에 구멍난 부분을 찾아내기 2018년에 챗봇을 개발했던 경험과 비교해서 최근의 기술이 얼마나 혁신적인지 이야기합니다. 기본적인 것은 AI가 처리해 주고 개발자들은 대화의 품질을 높이는 활동에 집중할 수 있습니다. 트렌드의 변화에 따라 문서를 개선하고 다시 작성해 주면 개발자 만족도는 높아질 수 있습니다. 규모가 작은 경우에는 가능한 일이겠지만, 규모가 큰 조직에서는 당연히 모든 문서를 다시 작성하는 것은 불가능한 일입니다. RAG 시스템을 구현한다고 해서 한 번에 결과를 만드는 것은 아닙니다. 지속적으로 최적화 작업이 필요합니다. 다른 세션에서도 이야기했듯이 사용자의 질의를 분석한다는지 부족한 정보를 채우는 일은 여전히 사람의 몫입니다. 마스터 카드에서 어떤 도구를 사용하는지 모르겠지만 문서 시스템을 시각화해서 보여준 것이 인상적.. AI The Docs 2024 - 이번 세션은 kapa.ai 영업 활동입니다 2024년 행사에서도 자주 언급된 기업이죠. kapa.ai 공동 창업자인 Emil Soerensen의 발표입니다. 창업을 하기 전에는 매킨지에서 컨설턴트, 매니저로 일했고 바로 창업을 했네요. 학부는 경영학, 경제학 쪽인데 석사를 컴퓨터 공학으로 받았습니다. 아마 이때부터 창업을 준비한 것이 아닌가 싶네요. 발표는 3가지로 설명합니다. LLM 개요와 기술 문서에서 LLM을 어떻게 활용하는지, Q&A 순서입니다. LLM을 설명한다고 하지만 아무래도 제품을 설명하지 않을 수 없다 보니 전반적으로 kapa.ai 중심으로 설명이 진행됩니다. LLM에 대한 설명은 실제로 kapa.ai가 어떻게 동작하는지를 가지고 설명합니다. 1. Connect technical knowledge sources 일반적으로 문서에 .. AI The Docs 2024 - API 연동에 도움이 되는 문서 만들기 API를 제공하면서 부족한 문서 품질은 사용자가 원하는 기능을 쉽게 찾을 수 없고 결국에는 API 채택에 영향을 미칩니다. OAS(Open API Specification)나 AsyncAPI specification 기반으로 만드는 문서는 사용자가 빵을 만들 수 있는 각각의 재료만 제공할 뿐 어떻게 만들어야 하는지 구체적인 레시피를 제공하지는 않습니다. 실제 사용자가 원하는 작업을 진행하기 위해서는 여러 API를 필요와 순서에 따라 사용해야 하는데(레시피) 이런 가이드가 부족하다는 이야기입니다. 이러한 레시피를 포함해 API를 사용할 때 고려해야 할 여러 가지 요소가 사용자뿐 아니라 AI에게도 중요한 요소입니다. 사용자가 겪는 어려움을 AI도 겪을 수 있다는 이야기입니다. 간단한 데모를 진행합니다. 애.. 이전 1 2 3 4 ··· 23 다음
