방문자 안내, 어디에 넣어야 할지 몰라서 학습메이트한테 골라달라고 했다

이 글은 이런 분께

• “설명 좀 남겨줘”처럼 짧게 부탁했는데, 막상 어디에 넣어야 할지 애매했던 경험이 있는 분
• 방문자가 내 프로젝트를 볼 수 있는 경로가 하나가 아닐 수 있다는 걸 놓치기 쉬운 분

Before — “설명을 남겨줘”인데, 어디에?

5일차 최종 리허설을 끝내고 4주 로드맵을 다 채운 뒤, 이렇게 부탁했다.

처음 보는 사람이 알아볼 수 있게 설명을 남겨줘.
- 이게 뭐 하는 건지
- 어떻게 쓰는지 (처음 여는 사람 기준으로)
- 뭐가 필요한지 (준비물이 있다면)
너무 길지 않게, 읽기 쉽게 써줘.

내용은 명확했다. 그런데 “어디에” 넣을지가 빠져 있었다. 강의안 GPT를 처음 만나는 사람이 볼 수 있는 자리가 한 곳이 아니었기 때문이다 — 사이트의 프로젝트 상세 페이지일 수도 있고, GitHub 저장소의 README일 수도 있고, GPT를 직접 열었을 때 보이는 대화 시작 화면일 수도 있었다.

어떻게 — 짐작하지 않고 학습메이트한테 골라달라고 했다

학습메이트가 짐작해서 아무 데나 넣는 대신, 세 가지 선택지를 정리해서 물어봤다.

1. 프로젝트 페이지에 (추천) — 상세 페이지의 “체험하기” 버튼 근처에 방문자용 안내 박스로
2. GPT 안(대화 시작 화면) — ChatGPT GPT 빌더 설정이라 내가 직접 붙여넣어야 하는 영역
3. 둘 다

“프로젝트 페이지에 (추천)“를 골랐다. 사이트만 고치면 되니 학습메이트가 바로 반영할 수 있는 선택지였다.

막힘 → 하나로 끝난 게 아니었다

프로젝트 페이지에 “처음 오셨다면 (이용 안내)” 섹션을 넣고 나서 다음 요청을 했는데, 그게 이거였다.

README 파일에

문장이 중간에 끊겨서 뭘 원하는지 애매했다. 이어서 “설명을남겨줘”가 왔고, 그제서야 맥락이 맞춰졌다 — README에도 같은 설명을 남겨달라는 뜻이었다. 분명 “프로젝트 페이지에”로 골랐었는데, 실제로 필요한 건 둘 다였던 거다.

After — 결국 두 군데 다 채웠다

두 곳 다 “뭐 하는 건가요 / 어떻게 써보나요 / 뭐가 필요한가요” 3단 구조로 통일해서, 어느 경로로 들어와도 같은 형식의 안내를 보게 만들었다.

배운 것 / 재사용 자산

방문 경로가 두 개면, 안내도 두 곳에 필요할 수 있다. 처음엔 “어느 한 곳을 고르면 되겠지” 싶었는데, 실제로는 사이트로 오는 사람과 저장소부터 보는 사람이 둘 다 있을 수 있어서 하나만으로는 부족했다. AI한테 “이거 어디에 넣을까”를 먼저 물어보게 한 것도 도움이 됐다 — 짐작으로 아무 데나 넣었으면 나중에 또 손봐야 했을 것이다.

재사용 템플릿 (첫 방문자 안내 3단 구조)

뭐 하는 건가요? — 한두 문장으로 결과물이 뭔지
어떻게 써보나요? — 처음 여는 사람 기준으로 1, 2, 3 단계
뭐가 필요한가요? — 준비물 (없으면 "이것만 있으면 돼요")