기능이 늘어날수록 소개 문서는 항목 수만 불어나고, 이용자는 자기에게 필요한 항목을 찾다가 문의 창구로 넘어옵니다. 문장을 다듬기 전에 기능을 어떤 기준으로 묶고 있는지부터 살펴보는 편이 낫습니다.
기능을 묶는 기준을 정합니다
묶음의 기준은 제품 내부의 모듈 구분이 아니라 이용자가 하려는 일입니다. 같은 목적으로 찾게 되는 기능을 한 항목 아래 모으고, 목적이 겹치지 않는 기능은 따로 세웁니다. 상위 묶음이 다섯 개를 넘어가면 기준이 두 겹으로 섞였는지 확인합니다.
설명 문장의 층위를 맞춥니다
한 문서 안에서 어떤 기능은 한 줄로, 어떤 기능은 화면 단위로 서술되면 비중이 실제와 다르게 읽힙니다. 항목마다 무엇을 하는 기능인지 한 문장, 어떤 상황에서 쓰는지 한 문장으로 길이를 맞춥니다. 더 긴 설명이 필요한 항목은 별도 문서로 빼고 연결만 남깁니다. 항목 길이가 들쭉날쭉하면 어떤 기능이 핵심인지 잘못 읽히므로 분량 기준을 문서 규칙에 적어 둡니다.
화면 명칭 표기를 통일합니다
같은 화면을 문서마다 다른 이름으로 부르면 검색으로 찾아온 이용자가 같은 기능을 두 개로 인식합니다. 제품 화면에 실제로 표시되는 문구를 기준 이름으로 삼고, 문서에서 쓰는 별칭은 목록으로 관리합니다. 화면 문구가 바뀌면 그 목록을 열어 영향받는 문서를 한 번에 찾습니다.
묶음을 바꿀 때 처리할 것
분류를 손보면 문서 주소와 안쪽 연결이 함께 흔들립니다. 항목을 옮기기 전에 어느 문서가 그 항목을 참조하는지 목록으로 만들고, 이동 후에 같은 목록으로 되짚습니다. 이전 위치를 기억하는 이용자를 위해 옮긴 사실과 새 위치를 한 줄로 남겨 둡니다.