그냥 번역 (12) 썸네일형 리스트형 AI 에이전트를 위한 '제품 스킬(Product Skill)'은 과연 필요한가? 구글의 테크니컬 라이터 Tom Johnson의 질문과 토론을 정리한 글입니다.원문 전체를 번역한 것은 아니며, Gemini와의 대화(?)를 통해 정리한 내용입니다.원문은 아래 링크에서 확인할 수 있습니다.https://writethedocs.slack.com/archives/C1NEAD7D4/p1790699425280749 최근 AI 에이전트(Claude Code, Cursor 등)가 개발 생태계에 깊숙이 들어오면서, 제품 개발사와 테크니컬 라이터들 사이에서 "제품 스킬(Product Skill)" 혹은 "Agent Skill"을 정의하고 제공하는 방식에 대한 논의가 뜨겁습니다.Tom Johnson이 던진 화두와 이에 대한 현업 전문가들의 가치 있는 통찰을 정리해 공유합니다. 질문의 시작: 스킬은 단순.. AI가 TW의 일자리를 위협할 때 살아남는 두 가지 전략 Tom Johnson은 AI와 문서화 관련해서 가장 활발하게 자신의 생각을 공유하고 있는 이들 중 하나입니다. 지난 주말에 올린 "Two strategies to succeed when AI seems to be eroding jobs around you"라는 글을 번역해서 공유해 봅니다. 사실 이제는 브라우저에서 자동으로 번역하는 도구들이 많아져서 이렇게 올리는 것이 큰 의미는 없지만, 개인적으로 글을 좀 깊게 읽어보고자 하는 일입니다.원문: https://idratherbewriting.com/blog/strategies-to-succeed-in-context-of-ai 요약: 지난 한 해, 기술 커뮤니케이션 업계에서는 AI로 인한 직업 안정성에 대한 우려가 컸습니다. 이 글에서 저는 우리의 역할이 .. 도움이 될 만한 12가지 릴리스 노트 예시 (소프트웨어 개발 및 협업 도구) 원문은 55가지를 소개하고 있는데 그 중에서 "소프트웨어 개발 및 협업 도구"에 해당하는 12가지만 소개해봅니다. 화면 캡처 시점이 2022년 11월인 것을 보면 이 글이 작성된 시점은 2023년 즈음이 아닌가 싶은데 Wayback Machine으로 확인해보면 2024년 하반기입니다(정확한 게시 일자를 확인할 수 없네요). Amoeboids는 아틀라시안 마켓플레이스 앱을 개발하는 IT 서비스 화시라고 합니다. 제품군 중에 자동으로 릴리스 노트를 생성하는 것이 있어 이런 콘텐츠를 만든 것이 아닌가 싶네요. https://amoeboids.com/atlassian-apps/automated-release-notes-for-jira/원문은 아래 링크를 참고하세요. https://amoeboids.com/bl.. AI를 위한 문서 작성: 베스트 프랙티스 Writing documentation for AI: best practices이라는 문서에 대한 번역입니다. 개인적인 학습 용도이며, 아마도 이 글을 보는 것보다 이 글을 작성한 시점보다 좀 더 나아진 기계번역의 힘을 빌리는 것이 좀 더 좋은 방법이라 생각됩니다.https://docs.kapa.ai/improving/writing-best-practices * Kapa라는 서비스를 홍보하기 위한 콘텐츠라는 것을 잊지 마세요 ^^ AI를 위한 문서 작성: 베스트 프랙티스Kapa와 같은 검색증강생성(RAG) 시스템은 정확하고 유용한 정보를 제공하기 위해 여러분의 문서에 의존합니다. 문서가 사람과 기계 모두에게 잘 제공될 때, 명확한 문서는 AI 답변의 품질을 높이고, 그 답변이 다시 문서의 부족한 부분을 .. API 문서 작성을 위한 로버트의 가이드라인 Robert's Rules of Order for API Documentation Writing이라는 문서에 대한 번역입니다. 개인적인 학습 용도이며, 아마도 이 글을 보는 것보다 이 글을 작성한 시점보다 좀 더 나아진 기계번역의 힘을 빌리는 것이 좀 더 좋은 방법이라 생각됩니다.https://writeonce.org/roberts_rules_of_order.php 참고로 원문 제목에서 Robert's Rules of Order이라는 것은 미국 내에서 사용하는 회의 규칙 같은 것이라고 하는데요. 아마 글쓴이는 이를 패러디한 것이 아닌가 싶네요. 이걸 알면 괜찮은데 그대로 직역하면 좀 어색한 표현이 되어서 그냥 가이드라인 정도로 번역했습니다.(참고: https://en.wikipedia.org/wiki/R.. GenAI 기반 에이전트를 위한 콘텐츠가 준비되어 있나요? GenAI 기반 에이전트를 위한 콘텐츠가 준비되어 있나요? 라는 문서에 대한 번역입니다. 개인적인 학습 용도이며, 아마도 이 글을 보는 것보다 이 글을 작성한 시점보다 좀 더 나아진 기계번역의 힘을 빌리는 것이 좀 더 좋은 방법이라 생각됩니다. https://www.tcworld.info/e-magazine/intelligent-information/is-your-content-ready-for-genai-based-agents-1316/ 인간 사용자와 마찬가지로 GenAI는 정확한 응답을 생성하기 위해 정교하고 풍부한 텍스트 정보가 필요합니다. 새로운 시대에 대비하여 콘텐츠를 준비하는 방법은 다음과 같습니다. 생성형 인공지능(Generative Artificial Intelligence, GenAI)의.. 문서 업데이트 시 AI 활용하기 Using AI to create doc updates based on bugs 라는 문서에 대한 번역입니다. 개인적인 학습 용도이며, 아마도 이 글을 보는 것보다 이 글을 작성한 시점보다 좀 더 나아진 기계번역의 힘을 빌리는 것이 좀 더 좋은 방법이라 생각됩니다. https://idratherbewriting.com/learnapidoc/docapis_ai_fix_bugs.html Using AI to create doc updates based on bugs Download PDF idratherbewriting.com 저는 사용자가 등록한 버그를 상시 확인하고 문서를 업데이트합니다. 이런 작업은 새로운 기능에 대한 문서를 작성하는 것이 아니라 이미 공개된 문서에 대한 수정이 필요한 상태입니다. 예를.. 2022 데브옵스 현황 보고서 데이터 심층 분석: 문서화는 봄날의 햇살입니다 2022 State of DevOps Report data deep dive: Documentation is like sunshine 문서에 대한 번역입니다. 한국어 블로그에 번역이 올라오긴 하지만 약 한 달 정도 차이가 있는 것 같더군요. 개인적인 학습 용도이며, 아마도 이 글을 보는 것보다 이 글을 작성한 시점보다 좀 더 나아진 기계번역의 힘을 빌리는 것이 좀 더 좋은 방법이라 생각됩니다. June 16, 2023 https://cloud.google.com/blog/products/devops-sre/deep-dive-into-2022-state-of-devops-report-on-documentation?hl=en 기술 조직의 내부 문서는 소프트웨어 개발의 기본적인 부분입니다. 지난 2년 동안 D.. 이전 1 2 다음
