개발자 포트폴리오를 읽는 사람은 같은 정보를 찾지 않습니다. 짧은 시간에 지원 직무를 확인하는 사람도 있고 코드와 설계 판단을 자세히 보는 사람도 있습니다. 첫 화면과 기술 상세를 두 겹으로 나누면 서로 다른 질문에 답하기 쉽습니다.
첫 화면: 세 가지 답
무슨 직무를 목표로 하는가, 어떤 프로젝트를 대표로 보여 주는가, 그 프로젝트에서 본인이 무엇을 했는가를 바로 찾을 수 있게 합니다. 프로젝트마다 한 문단 요약과 실행·저장소 링크를 둡니다.
상세 페이지: 검증 자료
문제 정의, 설계 대안, 구현 위치, 테스트, 배포·운영 결과, 한계를 순서대로 적습니다. 수치 성과가 있다면 측정 환경을 포함하고, 없으면 실제 수행한 일만 설명합니다. 팀 프로젝트는 개인 기여를 분리하세요.
저장소: 다시 실행할 수 있게
README에 필요한 도구와 실행 명령, 예제 설정, 테스트 방법을 적습니다. GitHub README 공식 안내를 참고해 저장소 첫 화면이 길 찾기 역할을 하는지 확인하세요.
두 화면을 연결
첫 화면에서 상세 페이지로, 상세 페이지에서 코드·배포로 이동하는 링크를 시험합니다. 모바일에서도 같은 경로가 유지되어야 합니다. 웹사이트·PDF·GitHub의 형식별 장단점은 포트폴리오 형식 비교를 참고하세요. 특정 구성만이 합격을 만든다는 뜻은 아닙니다.