이 프로젝트는 무엇을 위한 것인가
어떤 문제를 해결할 수 있는가
왜 이 프로젝트가 유용한가
어떤 사람들이 이 프로젝트를 사용하면 좋은가
이 프로젝트는 어떻게 작동하는가
2. 프로젝트를 시작하는 방법
프로젝트를 처음 사용하기 위해 필요한 내용을 포함하는 것이 좋다.
프로젝트를 설치, 사용하기 위해 필요한 전제조건이 있는가
어떻게 설치, 사용, 테스트하는가
설치 가이드 문서는 어디에 있는가
3. 저작권, 라이선스 정보
프로젝트의 사용 범위 및 조건을 설명하는 내용을 포함하는 것이 좋다.
어떤 라이선스로 배포되는가?
상세한 라이선스 정보는 어디에서 확인할 수 있는가
프로젝트를 사용함에 있어 제약 조건이 있는가(특허, 상업적 사용)
4. 외부 리소스 정보
프로젝트 내에 포함된 외부의 코드나 리소스의 정보를 포함하는 것이 좋다.
각각의 출처 및 배포 라이선스는 무엇인가
결론
좋은 Readme를 작성할때, 포함하면 좋은 내용들을 간단하게 확인해 보았다.
좋은 템플릿을 만들어 놓은 페이지도 있고, 여러 대형 프로젝트 레포지터리를 구경다니면서 좋은점을 추가해나가는것도 좋다고 생각한다.
레포지터리 템플릿
README 템플릿1
README 템플릿2