▲GN⁺ 2025-04-20 | parent | ★ favorite | on: Show HN: GitHub 코드베이스를 쉬운 튜토리얼로 변환하는 AI(github.com/The-Pocket)Hacker News 의견 저장소의 문서나 코드만 사용하는지에 대한 질문이 있음 AI 스튜디오 API 키를 사용해 시도해봤고 인상적이었음 API를 설명하는 데 레스토랑 비유를 사용하는 것은 불필요하게 길게 느껴짐 GraphQL에 대한 설명도 과도하게 길게 이어짐 생성된 문서는 소프트웨어 엔지니어보다는 약간 기술적인 PM에게 더 적합해 보임 프롬프트를 개선하여 이를 완화할 수 있을 것 같음 프롬프트가 다이어그램의 다양성을 장려하면 좋을 것 같음 예를 들어, AWS Step Functions를 사용한 내구성 있는 상태 머신 워크플로우에는 순서도보다 흐름도가 더 적합할 수 있음 새로운 라이브러리를 사용할 때 첫 번째 단계로 저장소를 복제하고 Claude 코드를 실행하여 좋은 문서를 작성하도록 요청함 많은 단계를 절약할 수 있을 것 같음 Cursor에게 많은 질문을 하여 비슷한 결과를 얻음 다른 사람도 언급했듯이 약간 다른 톤을 원함 선호하는 글쓰기 스타일에 맞출 수 있는 "스타일 템플릿" 기능이 좋을 것 같음 시간이 많이 걸리지 않는다면 PR을 제출할 수도 있음 mutable ai라는 회사가 작년에 Google에 인수되었는데, 튜토리얼 대신 위키를 출력하는 작업을 했음 dspy 튜토리얼이 훌륭함 dspy는 개념적으로 이해하기 어렵지만 튜토리얼이 잘 설명해줌 브라우저 사용을 위해 구축함 라이브러리의 결과가 매우 인상적임 출력은 전혀 손대지 않았음 현재 코드베이스와 문서를 유지하는 데 문제가 있음 (코드 예제가 가끔 깨짐) Pocket의 일부를 사용하여 이를 해결할 수 있을지 궁금함 정말 멋진 작업이고 공유해줘서 고맙다는 의견 LLM의 가치를 잘 보여주는 예시임 주니어 엔지니어에게 미치는 부정적인 시각을 극복하는 데 도움을 줌 대부분의 프로젝트가 최신 문서가 부족한 문제를 해결하는 데 도움을 줌 새로운 오픈 소스 기여자의 온보딩에 게임 체인저가 될 수 있음 postgres나 redis 코드베이스를 넣고 잘 이해하여 기여를 시작할 수 있음 상위에는 깔끔한 고수준 내용이 있지만, 그 아래로는 인간 언어로 작성된 코드로 빠르게 전환됨 관련 단위 테스트를 살펴보면 더 유용한 사용 패턴을 추출할 수 있을 것 같음 대부분의 튜토리얼 독자에게 중요한 것은 "사용 방법"임
Hacker News 의견