다국어 문서 사이트의 개척지
여러 언어의 API 문서를 한 사이트에 모으려면 서로 다른 문서 생성기를 연결하고 탐색·검색 경험을 통일해야 합니다. 글쓴이는 변환, 생성 결과물 병합, 수동 작성의 장단점을 살피고 Pigweed에서 Pagefind와 공통 헤더로 검색과 이동을 통합한 과정을 소개합니다.
개발 · 최신기사
언어와 프레임워크, SDK와 개발 방식·도구의 변화를 다룹니다.
사람들에게 돈을 주고 README를 따라 해보게 했습니다
ActivityBot 개발자가 시간당 25유로를 주고 사용자에게 README를 따라 해보게 한 뒤, 막히는 지점마다 문서를 고쳤습니다. 새 컴퓨터에서 명령을 직접 실행하는 것만으로는 놓치기 쉬운 용어·설명·구성의 문제를 실제 사용자의 반응으로 찾았습니다.
에이전트에게 필요한 것은 기억이 아니라 문서입니다
글쓴이는 대화에서 잘라낸 조각을 벡터 검색으로 불러오는 에이전트 메모리가 오래되거나 맥락을 잃고, 무엇이 빠졌는지도 알기 어렵다고 지적합니다. 대신 Markdown 문서를 지식 저장소로 삼아 작업 전 읽고 작업 후 갱신하는 방식을 제안합니다.
GitHub Wiki는 안티패턴입니다
GitHub Wiki는 저장소 어디서나 한 번에 접근할 수 있다는 장점이 있지만, 문서를 코드와 함께 버전 관리하고 코드처럼 리뷰하려면 저장소의 /docs 폴더가 더 낫다고 주장합니다. GitHub Pages로 문서를 공개하고 Wiki에는 안내 링크만 두는 방식을 제안합니다.