# 좋은 README 작성하는 방법

> Clean Markdown view of GeekNews topic #10941. Use the original source for factual precision when an external source URL is present.

## Metadata

- GeekNews HTML: [https://news.hada.io/topic?id=10941](https://news.hada.io/topic?id=10941)
- GeekNews Markdown: [https://news.hada.io/topic/10941.md](https://news.hada.io/topic/10941.md)
- Type: news
- Author: [ironlung](https://news.hada.io/@ironlung)
- Published: 2023-09-19T10:30:23+09:00
- Updated: 2023-09-19T10:30:23+09:00
- Original source: [insight.infograb.net](https://insight.infograb.net/blog/2023/08/23/good-readme)
- Points: 22
- Comments: 0

## Topic Body

- README 파일 존재 이유  
    - README는 코드 프로젝트 첫인상을 결정짓는 중요한 콘텐츠  
    - 프로젝트 얼굴이자 사용 설명서  
    - 코드 존재 이유와 코드가 해결하는 문제, 코드의 중요성 이해 도움  
        - 프로젝트 목적, 설치 방법, 사용 방법 설명  
        - 프로젝트에 참여하는 모든 이에게 중요한 정보 제공, 코드 가치 높임  
    - 훌륭한 README는 프로젝트 성공에도 큰 영향 미칠 수 있음  
    - 코드는 문제 해결 위해 존재, 그 문제 중요성과 해결 방법을 README로 명확히 전달  
- README가 없는 프로젝트  
    - 안내판이 없는 미로  
    - 프로젝트에 관심이 떨어지고, 유용한 프로젝트가 널리 알려지지 못할 수 있음  
    - 개발자가 프로젝트 유지보수, 개선하는 데 어려움  
        - 기존 코드 구조나 사용방법 파악하는 데 시간 많이 걸림  
- README 작성 요건  
    - 항상 최신 정보를 담아야 함  
        - 프로젝트에 변경 사항이 생기면 README도 함께 업데이트해야 함  
    - README는 간결하되, 필요한 모든 정보 제공해야 함  
    - 내용이 길어지면 목적별로 새로운 경로 생성해 파일 저장, 하이퍼링크 추가  
- README에 담을 내용  
1)프로젝트의 주요 기능과 목적  
2)설치 방법: 단계별 설치 가이드, 설치에 필요한 도구와 라이브러리, 환경 설정 안내  
3)문제 해결 방법: 자주 발생하는 문제와 해결 방법  
4)지원 창구: 프로젝트 주요 유지 관리자나 커뮤니케이션 담당자와 소통 방법  
5)라이선스 정보: 라이선스는 코드 사용, 수정, 배포 관련 권리와 제한 명시  
6)변경 로그: 프로젝트의 주요 업데이트 내역  
7)사용 예시  
8)추가 학습 자료와 문서 링크  
9)사전 요구사항: 사용자가 프로젝트 설치 실행할 환경 쉽게 구성하도록 지원 목적

## Comments



_No public comments on this page._