개발자 포트폴리오 예시를 고를 때는 제출 조건과 보여줄 자료의 종류부터 정하세요. PDF는 요약과 확정된 제출본을, 웹페이지는 탐색과 데모 연결을, 저장소 README는 실행과 코드 설명을 담는 방식으로 구성할 수 있습니다.
이 글은 형식별 합격률 순위가 아니라 자료를 나누는 편집 기준입니다. 회사가 지정한 양식·파일·용량 조건이 있다면 그 안내를 우선하고, 본인의 기여가 드러나는 프로젝트부터 배치하세요.
PDF·웹페이지·README에 각각 다른 역할을 맡기세요
| 형식 | 담기 좋은 내용 | 제출 전 점검 |
|---|---|---|
| 역할·대표 프로젝트·핵심 근거의 요약 | 글자·페이지·파일 조건과 링크 | |
| 웹페이지 | 프로젝트 탐색과 데모·문서 연결 | 모바일 보기와 공개 접근 |
| README | 목적·설치·실행·테스트와 코드 안내 | 설명만으로 재현 가능한지 |
하나의 형식에 모든 코드를 넣기보다 요약에서 근거로 이동할 경로를 만드세요. 예를 들어 PDF의 프로젝트 카드에서 웹 데모와 저장소를 연결하고, README에서 실행 조건을 설명하는 구성입니다.
GitHub README 공식 안내는 프로젝트의 목적, 활용과 시작 방법을 전달하는 역할을 설명합니다. 저장소 문서에는 단순 화면 캡처보다 실제 사용·실행 방법을 포함하는 편이 목적에 맞습니다.
대표 프로젝트 카드는 같은 질문에 답하게 만드세요
프로젝트마다 제목과 사진만 나열하면 독자가 본인의 역할을 찾기 어렵습니다. 각 카드에서 목적, 담당 범위, 핵심 결정과 검증 자료를 같은 위치에 배치해보세요.
프로젝트: [실제로 만든 결과물]
목적: [해결하려고 한 문제]
기간과 구성: [실제 수행 기간·팀 여부]
내 역할: [직접 맡은 기능과 결정]
핵심 선택: [비교한 대안과 선택 이유]
검증: [실행·테스트·측정 기록]
현재 상태: [동작 범위와 남은 작업]
링크: [데모·저장소·설명 자료]위 블록은 채워 쓰는 편집 틀이며 실제 합격자의 원문이 아닙니다. 수치를 확인하지 않았다면 개선율을 만들기보다 관찰한 변화와 확인 방법을 적으세요. 팀 결과와 개인 기여를 구분해 쓰는 것이 좋습니다.
요약 화면에서는 독자가 다음에 볼 것을 알려주세요
첫 부분에는 지원 직무, 대표 프로젝트와 본인의 기여 요약을 배치하세요. 연락 방법은 필요한 범위만 공개하고, 회사의 제출 양식이 따로 있으면 같은 정보를 불필요하게 중복하지 않는 편이 좋습니다.
기술 스택은 로고 개수보다 사용 목적을 설명하세요. “데이터를 저장하기 위해 사용”, “이 실패 조건을 테스트하기 위해 사용”처럼 기능과 연결하면 해당 기술을 어디까지 사용했는지 파악하기 쉽습니다.
프로젝트의 순서는 지원 공고와 관련 있는 결과물을 기준으로 정하세요. 개인 기여·실행·문제 해결을 점검하는 체크리스트를 이용하면 앞에 배치할 자료를 선택할 수 있습니다.
실행 설명과 문제 해결 기록은 상세 자료로 연결하세요
요약에서 설명이 길어지는 부분은 저장소나 별도 문서로 연결하세요. 설치 조건, 환경 변수 이름, 테스트 명령, 재현 데이터와 현재 제약을 정리하면 요약의 길이를 줄이면서 근거를 유지할 수 있습니다.
문제 해결 기록에는 증상, 원인을 좁힌 과정, 검토한 선택, 수정과 확인 결과를 적어보세요. 스크린샷만으로 동작 여부를 설명하기 어려운 경우에는 입력과 결과를 확인할 수 있는 자료를 함께 남겨두세요.
README와 재현 코드 중심의 데이터분석 포트폴리오 구조도 참고할 수 있습니다. 분석 결과뿐 아니라 코드와 데이터의 준비 조건을 연결하는 방식은 다른 프로젝트의 문서 구성에도 활용할 수 있습니다.
공개 링크와 제출본을 실제로 열어보세요
로그인하지 않은 환경에서 포트폴리오와 저장소 링크가 열리는지 확인하세요. 비공개 저장소라면 공개 가능한 설명 자료를 선택하고, 접근 권한을 요구하는 자료는 제출 안내와 맞는지 점검해야 합니다.
PDF는 실제 내려받아 모바일과 일반 화면에서 글자가 읽히는지 확인하고, 웹페이지는 링크와 데모가 동작하는지 살펴보세요. 파일에 들어간 개인정보, 고객 자료, 키와 내부 주소도 확인하세요.
이력서와 포트폴리오의 프로젝트 기간·역할·기술 이름이 서로 일치하는지 마지막으로 대조하세요. 형식을 예쁘게 만들었어도 설명과 실제 코드가 다르면 질문에 답하기 어려워집니다.
자주 묻는 질문
웹 포트폴리오가 PDF보다 합격률이 높나요?
그 차이를 단정할 검증 자료를 이 글에서 제시하지 않습니다. 제출 조건을 확인하고 요약·탐색·실행 설명에 맞는 형식을 선택하세요.
페이지 수와 프로젝트 수는 어떻게 정하나요?
먼저 공고의 제한을 확인하세요. 제한이 없다면 본인의 기여와 직무 관련성을 설명할 수 있는 대표 결과물을 고르고, 상세 근거는 링크로 연결하는 방법을 권합니다.
지금 할 일
대표 프로젝트 한 개를 카드 틀에 채우고 요약·데모·실행 설명을 연결하세요. 독자가 목적과 개인 기여를 읽고 근거까지 확인할 수 있는 구조가 포트폴리오 구성의 결과물입니다.