GitHub wiki는 안티패턴이다
The GitHub wiki is an anti-pattern
GitHub 프로젝트 문서화에 wiki 대신 /docs 폴더를 사용해야 하는 이유를 설명한다. wiki의 유일한 장점은 접근성뿐이며, 코드와 함께 버전 관리되지 않고, 로컬에서 사용할 수 없으며, PR 리뷰를 받지 않고, 이미지 업로드도 지원하지 않는다. /docs 폴더를 사용하면 문서를 코드와 함께 버전 관리하고, PR 리뷰를 거치며, GitHub Actions로 린트할 수 있다. GitHub Pages로 문서를 호스팅하고, wiki에는 안내 페이지만 두는 것이 좋다.
내가 찾을 수 있었던 wiki 사용의 유일한 이점은 그것이 항상 거기에 있다는 것이다.