GitHub 저장소가 많다고 포트폴리오가 자동으로 좋아지는 것은 아닙니다. 방문자가 대표 프로젝트를 찾고 실행 방법과 본인 기여를 이해할 수 있어야 합니다. 공개 저장소를 정리할 때에는 첫 화면부터 점검하세요.
대표 프로젝트를 고르는 기준
지원 직무와 관련 있고 현재 코드가 열리며, 구현 이유를 설명할 수 있는 저장소를 우선합니다. 수업 예제를 그대로 복제한 저장소라면 본인이 바꾼 부분을 분명히 적으세요. 오래된 실습은 무조건 삭제하기보다 대표 목록에서 제외하고 보관할 수 있습니다.
README에 있어야 할 내용
프로젝트 목적, 주요 기능, 기술 선택 이유, 설치·실행 방법, 환경 변수 예시, 테스트 방법, 제약을 순서대로 적습니다. 배포 주소가 있다면 현재 동작 여부를 확인합니다. GitHub 공식 README 안내는 저장소 방문자에게 보이는 위치와 역할을 설명합니다.
코드만큼 변경 기록도 중요
작은 단위의 커밋 메시지와 풀 리퀘스트 설명은 어떤 문제를 어떻게 해결했는지 보여 줍니다. 팀 프로젝트라면 본인이 작성한 변경과 리뷰 참여를 구분해 링크하세요. 커밋 수나 잔디 그래프를 성과 지표처럼 과장하지 않습니다.
공개 전 보안과 사용성 확인
비밀 키, 토큰, 고객 자료가 저장소 이력에 없는지 확인하세요. 링크를 로그아웃 상태에서 열고, 처음 보는 사람이 안내만 따라 실행할 수 있는지 테스트합니다. 파일을 삭제하는 것만으로 과거 커밋의 민감 정보가 사라졌다고 가정하면 안 됩니다. 포트폴리오 전체 구성은 개발자 포트폴리오 구성 가이드와 연결해 점검하세요.