포트폴리오가 읽히지 않는 이유를 ‘디자인이 약해서’라고만 판단하기 쉽습니다. 실제로는 링크가 열리지 않거나, 본인의 역할을 찾기 어렵거나, 결과를 재현할 수 없는 경우가 있습니다. 자신의 문서를 아래 순서로 점검하면 고칠 범위를 좁힐 수 있습니다.
문제 1: 프로젝트 목록만 있고 맥락이 없음
기술 스택과 화면 사진만으로는 어떤 문제를 해결했는지 알기 어렵습니다. 프로젝트마다 대상 사용자, 해결하려는 문제, 본인 담당, 결과, 남은 제약을 한 단락으로 적으세요. 같은 기술을 여러 번 썼다면 각 프로젝트에서 다른 판단을 한 지점을 보여 줍니다.
문제 2: 배포·저장소 링크가 작동하지 않음
모바일과 로그아웃 상태에서 각 링크를 열어 보세요. 비공개 저장소라면 접근 권한을 확인하고, 배포가 끝났다면 화면 캡처만 남기지 말고 현재 상태와 재현 방법을 적습니다. GitHub README 안내를 참고해 설치와 실행 정보를 첫 화면에서 찾게 하세요.
문제 3: 팀 성과를 개인 성과처럼 씀
팀의 프로젝트 설명 뒤에 본인이 구현한 기능과 리뷰·설계 참여 범위를 구분하세요. 면접에서 코드 위치와 선택 이유를 설명할 수 있어야 합니다. 측정하지 않은 개선율이나 실제 존재하지 않는 사용자 반응을 넣지 않습니다.
문제 4: 화면은 보이지만 사용이 어려움
작은 화면에서 글이 잘리는지, 키보드로 핵심 기능에 접근할 수 있는지, 입력 오류를 이해할 수 있는지 테스트하세요. 폼의 레이블과 오류 안내는 W3C WAI의 폼 접근성 안내로 확인할 수 있습니다.
한 번에 모든 문서를 다시 쓰기보다 깨진 링크, 모호한 역할, 재현 불가, 접근성 순서로 수정합니다. 수정 전후를 비교하는 방법은 포트폴리오 개선 사례 분석에서 이어집니다.