원페이지와 여러 페이지 중 하나를 먼저 고르면 내용이 그 형식에 억지로 맞춰질 수 있다. 나는 서비스의 전체 흐름을 이해하는 구간과 특정 글이나 기능을 다시 찾는 구간을 구별해 본다. 한 회사의 홈페이지 안에서도 두 역할을 함께 둘 수 있다.
실제 서비스 소개 소스에는 한 페이지의 여러 구간과 칼럼 상세 창이 있다. 도구형 프로젝트에는 전체 글 목록과 독립된 글·도구 주소가 있고, 이번 홈페이지에도 글과 모듈을 별도 주소로 발행한다. 어떤 형식이 무조건 더 낫다는 대신 각 구조가 맡는 읽기와 이동의 책임을 정리하려 한다.
한 번에 읽을 설명에는 연결된 순서가 도움이 된다
처음 서비스를 이해하는 사람은 하는 일, 진행 과정, 예시, 문의로 이어지는 전체 관계를 볼 수 있어야 한다. 한 페이지의 구간은 이런 설명을 이어서 읽는 길을 만들 수 있다. 서비스 소개 소스는 구간 식별자를 두고 메뉴와 버튼으로 필요한 부분에 이동하도록 구성했다.
다만 한 페이지라는 이유로 모든 내용을 같은 길이로 넣지 않는다. 각 구간이 다음 판단에 필요한 설명인지, 이미 나온 문장을 반복하는지 확인한다. 자주 갱신되는 상세 자료와 긴 구현 설명까지 전부 홈에 넣으면 새로운 방문자가 전체 방향을 이해하는 흐름이 흐려질 수 있다. 소개의 요약과 상세의 깊이를 구별한다.
상세 창을 쓰더라도 다시 열 길을 생각한다
확인한 서비스 소스는 칼럼을 누르면 상세 창을 열고 주소의 검색 조건에 글 식별자를 넣는다. 닫을 때 그 조건을 제거하고 목록 구간을 가리키며, 뒤로 이동할 때 주소에서 선택한 글을 다시 읽는 코드도 있다. 상세 창이기 때문에 공유할 길이 전혀 없다고 설명하면 실제 구현과 다르다.
그렇다고 이런 창이 독립된 상세 문서와 같은 구조인 것도 아니다. 소개 페이지 위에서 글을 열고 닫는 흐름과, 글 자체의 주소로 들어가 읽는 흐름은 각각 확인할 점이 있다. 창의 닫기와 복귀, 주소로 직접 열기, 키보드와 초점 처리는 실제 화면에서 검토해야 한다. 이 글에서 새로 그런 브라우저 검수를 수행한 것은 아니다.
반복해서 찾는 자료에는 독립된 목적지가 필요하다
도구형 프로젝트의 글 목록은 짧은 제목과 설명으로 고르게 하고 본문은 글 주소에서 불러온다. 개별 기능도 도구 주소를 가진다. 글의 한 부분을 다시 읽거나 기능을 다시 사용할 때 전체 소개를 처음부터 탐색하지 않는 길이다. 목록은 선택을, 상세는 이해와 사용을 맡도록 나눴다.
이 분리는 페이지를 많이 만들어 보이기 위한 것이 아니다. 자료가 늘어나도 제목과 검색, 관련 글, 도구 연결을 관리할 수 있게 하는 구조다. 앞선 코드 검사에서는 글 메타데이터와 본문 파일의 연결, 별도 본문 묶음 생성을 확인했다. 그것이 실제 방문 속도를 얼마나 바꾸었는지는 측정하지 않았다.
글 속 구현과 별도 도구의 경계도 정한다
이번 편집실은 글 안에 이미지와 영상, 코드, 실행 HTML 예시를 함께 넣을 수 있게 확장했다. 설명 바로 옆에서 작은 동작을 확인할 수 있다는 장점이 있다. 실행 예제는 별도 프레임에 두고 필요한 외부 연결을 명시한다. 긴 설명을 읽는 본문과 예제의 화면이 서로 맡는 일을 구별한다.
작은 레이아웃이나 상태 변화를 보여주려면 글 속 예시가 맞을 수 있다. 반면 반복해서 입력하고 저장하거나 큰 화면에서 오래 쓰는 기능은 독립된 도구 페이지를 검토할 수 있다. 이 기준은 새 도구의 제안이며 모든 기능에 이미 독립된 페이지를 구현했다는 뜻은 아니다. 사용할 시간과 저장, 연결의 조건을 함께 판단한다.
분리한 뒤에도 처음 들어온 사람을 놓치지 않는다
글의 주소로 바로 들어온 사람은 홈의 앞선 설명을 읽지 않았을 수 있다. 제목과 요약, 해당 글의 문제와 적용 조건, 관련 설명과 돌아갈 목록이 필요하다. 같은 회사의 홈페이지 안에 있다는 이유로 모든 맥락을 이미 안다고 가정하지 않는다.
이번 블로그는 한국어와 영어의 글을 각각 발행하고 공개 목록, RSS, 사이트맵에 연결한다. 관리 API로 발행한 뒤 두 언어의 주소와 제목, 대표 주소, 목록 반영을 HTTP로 확인한다. 이런 공개 연결의 확인은 실제 화면에서 긴 글을 편하게 읽는지, 예제가 잘 조작되는지 검토한 결과와 구별한다.
고를 때는 읽기·복귀·운영을 함께 본다
페이지를 나눌 때는 방문자가 그 내용만 다시 찾을 이유가 있는지 묻는다. 독립된 제목으로 설명할 수 있는지, 갱신 주기가 다른지, 별도의 사용 상태가 필요한지도 본다. 한 페이지 안에 두면 이해가 이어지는 부분은 연결하고, 독립된 목적이 있는 자료는 찾아갈 길을 남긴다.
아래 질문은 이번 글을 위해 정리한 선택 기준이다. 실제 이용자 인터뷰나 원페이지와 여러 페이지의 성과 비교 결과는 아니다. 먼저 내용과 사용 목적에 답을 적고, 선택한 구조에서 직접 열기와 복귀, 작은 화면에서의 이동을 검토할 수 있다. 형식을 먼저 정하기보다 읽는 사람과 계속 관리할 사람의 일을 함께 보는 기준이다.
- 전체 서비스를 이해하는 설명인가, 독립해서 다시 쓰는 자료인가.
- 목록과 요약만으로 고르고 상세에서 충분히 읽을 수 있는가.
- 주소로 직접 들어와도 목적과 조건을 이해할 수 있는가.
- 상세를 닫거나 읽은 뒤 원래 목록으로 돌아갈 수 있는가.
- 별도 저장과 권한, 외부 연결이 필요한가.
- 자료가 늘어날 때 제목·분류·연결을 관리할 수 있는가.