OMM을 만들며 발견한 불편과 변경 이유를 기록합니다. 새 기능의 이름만 나열하기보다, 어떤 문제를 해결하려 했고 어디까지 확인했는지 남깁니다.

계획과 실제 반영 결과는 구분합니다. 개발 소스에 추가된 내용이 모든 배포 버전에서 바로 제공되는 것은 아니므로 관련 버전과 릴리스도 함께 확인합니다.

2026-10-25 · 웹사이트를 목적별로 나누려는 이유

분류: 설계 결정

어떤 불편이 있었나요?

한 페이지나 탭에 설명이 길게 이어지면 원하는 내용을 찾기 어려워집니다. 처음 사용하는 사람에게 필요한 소개와, 이미 사용 중인 사람이 찾는 명령어 설명이 섞이면 읽어야 할 분량도 늘어납니다.

문장이 길거나 기술 용어가 한꺼번에 나오면 기능의 의미보다 설명을 해석하는 데 먼저 시간을 쓰게 됩니다.

어떤 방향으로 바꾸나요?

상단 메뉴를 소개·활용법·모델·문서·소식으로 구분하는 방향을 정했습니다.

홈에서는 OMM이 무엇을 돕는지 짧게 설명하고 시작할 경로를 보여줍니다. 활용법에서는 하려는 일을 기준으로 준비 조건과 사용 순서를 안내합니다. 모델과 문서는 비교하거나 다시 찾아볼 정보를 제공합니다.

자세한 해설과 사례, 개발 배경은 노션 안내서에서 읽을 수 있도록 역할을 나눕니다.

문구는 어떻게 바꾸나요?

사용자가 얻는 결과를 먼저 설명하고, 그다음 작동 방식과 필요한 조건을 안내합니다.

‘강력한 기능을 제공한다’는 표현보다 어떤 작업을 할 수 있는지 구체적으로 씁니다. 전문용어는 처음 등장할 때 설명하고, 한 문단에는 한 가지 내용을 담습니다.

어디까지 확정된 내용인가요?

이 글은 웹사이트와 안내서의 구성 방향을 기록한 설계 노트입니다. 구현·검증·운영 반영 결과는 실제 확인한 내용을 기준으로 별도 기록합니다.

앞으로의 기록 방식

새 개발 기록에는 다음 내용을 남깁니다.