README작성법1 개발자 문서화가 중요한 이유(README, 회고, 전달력) 한 신입 개발자의 포트폴리오를 검토하면서 프로젝트를 실행하는 방법을 질문한 적이 있습니다. 저장소에는 완성된 화면과 사용 기술이 정리되어 있었지만, 설치 순서와 환경 설정은 찾기 어려웠습니다. 학생은 코드를 내려받은 뒤 필요한 패키지를 설치하고 환경변수를 입력하면 된다고 설명했습니다. 그러나 어떤 실행 환경이 필요한지, 환경변수에는 무엇이 들어가는지, 데이터베이스를 어떻게 준비해야 하는지는 본인도 기억에 의존하고 있었습니다.팀 프로젝트가 끝난 지 두 달밖에 지나지 않았지만 프로젝트를 처음부터 다시 실행하려면 이전 대화와 개인 메모를 찾아봐야 했습니다. 함께 작업하지 않은 사람이 저장소만 보고 실행하는 것은 사실상 불가능한 상태였습니다. 학생은 README를 작성했기 때문에 기록은 충분하다고 생각했지만, .. 2026. 8. 30. 이전 1 다음