사이드프로젝트 slecs

GitHub 프로필 README를 첫인상 중심으로 개선

목차

GitHub 프로필 README를 또 갈아엎었다. "화려도 +임팩트 강화"라고 커밋 메시지 남겼는데, 정확히는 불필요한 것들을 걷어내고 핵심만 빠르게 읽히게 다듬는 작업이었다.

채용 담당자나 협업 상대가 프로필을 볼 때 5초 안에 어떤 개발자인지 파악할 수 있어야 한다고 생각한다. 이게 단순한 UI 원칙처럼 들릴 수 있는데, 실제로 생각해보면 꽤 엄격한 기준이다. 5초면 스크롤 한 번 안 한다. 첫 화면에 뜨는 내용만으로 판단이 끝난다. GitHub 프로필은 이력서보다 먼저 보는 경우가 많고, 포트폴리오 사이트보다 접근성이 높다. 그러니 첫인상 관리에서 GitHub 프로필은 생각보다 중요한 자리를 차지한다.

5초 컷을 통과하려면

웹 사용자 시선 추적 연구를 보면 대부분 F자 패턴으로 읽는다. 첫 줄 전체 훑기, 두 번째 줄 일부 훑기, 그리고 왼쪽 세로 스캔. GitHub README도 예외가 아니다. 스크롤 없이 보이는 영역, 이른바 "above the fold"에 뭘 두느냐가 첫인상을 결정한다.

이번 개선에서 가장 신경 쓴 부분이 바로 이 구간이다. 이름과 역할, 한 줄 소개 다음에 바로 핵심 기술 스택과 연락처가 보여야 한다. 수치 기반 성과는 눈에 잘 안 들어오는 아래 섹션에 두기보다 가능하면 위로 끌어올리는 게 낫다. "개선했다"보다 "17.8s → 0.12s (145배)" 같은 표현이 훨씬 빠르게 읽히고, 기억에도 남는다.

핵심 기술 스택 배지는 5-7개 정도가 적당하다고 판단했다. 그 이상 넘어가면 오히려 역효과다. 배지가 20개면 어느 게 주력인지 모른다. 배지가 3개면 너무 단출해서 경력이 부족해 보인다. 5-7개 범위에서 실제로 자주 쓰는 것, 앞으로도 계속 쓸 것만 남겼다.

요소 기준
한눈에 읽힘 스크롤 없이 핵심 파악 가능
수치 기반 "개선했다" 보다 "17.8s → 0.12s (145배)"
최신 상태 오래된 정보는 신뢰를 낮춤
연락 경로 명확 LinkedIn, 포트폴리오 링크 노출

정보 계층 설계 - 무엇을 접고 무엇을 펼칠까

길이 조절이 생각보다 까다롭다. 정보가 적으면 허전하고, 많으면 읽기 싫어진다. 이 딜레마를 해결하는 방법 중 하나가 <details> 토글이다. GitHub 렌더러가 HTML 서브셋을 지원하기 때문에 Markdown 안에서 그대로 쓸 수 있다.

<details>
<summary>경력 상세 보기</summary>

...상세 내용...

</details>

이 구조의 장점은 관심 있는 사람은 펼쳐보고, 아닌 사람은 그냥 지나칠 수 있다는 점이다. 처음 보는 사람은 요약만 보고 판단하고, 더 알고 싶으면 토글을 연다. 정보 밀도를 사용자가 직접 조절하게 두는 방식이다.

다만 단점도 있다. 토글 안에 있는 내용은 기본적으로 숨겨져 있어서 접근성 관점에서 아쉬움이 생긴다. 그래서 수치 기반 성과처럼 임팩트가 큰 내용은 토글 밖에, 세부 프로젝트 설명이나 기술 스택 세부 사항은 토글 안으로 넣었다. 주요 정보는 항상 열린 상태로 노출되어야 한다는 원칙이다.

섹션 순서는 이렇게 잡았다:

  • 이름 + 한 줄 역할 소개
  • 핵심 기술 배지 (5-7개)
  • 대표 성과 또는 최근 프로젝트
  • 연락처 + 링크
  • 상세 경력 (토글)
  • 사이드 프로젝트 (토글)

이 순서가 정답은 아닌데, 나한테는 맞는 구조다. 총괄 팀장 포지션에서는 개인 기술보다 팀 성과나 시스템 설계 경험이 더 어필 포인트가 될 수 있기 때문에 그 부분을 위로 끌어올리는 게 맞다고 판단했다. 직군이나 경력 단계에 따라 최적 배치는 달라진다.

업데이트 주기와 신뢰도

프로필 README에서 가장 신뢰를 깎는 요소는 오래된 정보다. 몇 년 전에 마지막 업데이트된 기술 스택, 이미 종료된 사이드 프로젝트 링크, 지금은 쓰지 않는 기술 배지. 보는 사람 입장에서 이런 프로필을 보면 "이 사람이 지금 뭘 하고 있는지 모르겠다"는 인상을 준다.

그래서 6개월에 한 번 정도는 전체를 다시 읽어보면서 낡은 내용을 털어내는 루틴이 필요하다. 추가보다 삭제가 훨씬 어렵다. 당시엔 의미 있었던 프로젝트라도 지금 프로필에 도움이 안 된다면 내리는 게 낫다. 이번 작업에서도 섹션 몇 개를 아예 없앴다. 결국 불필요한 정보 제거가 가장 임팩트 있는 개선이었다.

GitHub 프로필은 이력서와 다르다. 이력서는 제출 전에 맥락에 맞게 조정하지만, 프로필은 항상 공개 상태로 노출된다. 언제 누가 볼지 모른다는 전제로 유지해야 한다.

댓글 0

첫 댓글 달아줘.