UX 개요

이 문서는

UX 설계의 첫 문서입니다. 누구를 위해, 어떤 원칙으로 조작과 모습을 설계했는지와, UX 설계의 네 문서가 각각 무엇을 담당하는지를 적습니다.

  • 입력: 01-requirements. 요구사항이 “무엇을 할 수 있어야 하는가”를 적으면, UX 설계는 “그 일이 사용자에게 어떤 조작과 모습으로 보이는가”를 정합니다.
  • 이 설계를 쓰는 곳: 상세 설계(편집기 03-editor, 레이아웃 · 렌더링 02-layout, 배포 대상의 셸), 프로토타입 리뷰(리뷰 순서).

1. 누구를 위한 편집기인가

  • 실무에서 설계 문서를 쓰는 사람이 주 사용자다. 그림은 코드 옆, 위키, PDF, 인쇄물에서 읽히는 남는 문서다 → 1. 핵심 원칙
  • 키보드로 빠르게 다루는 사람을 먼저 본다. 표준 키 위에 Vim 키를 더했다 → DR-0009
  • 화면의 텍스트는 영어가 기본이고 한국어를 지원한다 → R-NFR-04

2. UX 원칙

조작의 원칙입니다. 모습의 원칙은 1. 원칙에 따로 있습니다.

원칙뜻근거
구조를 편집하면 그림이 따라온다사용자는 좌표를 다루지 않는다. 블록을 삽입하고 감싸고 이동하면 그림은 자동으로 다시 그려진다ADR-0004
같은 일은 같은 방법으로블록 · 분기 · 다이어그램 · 접기 영역에 같은 종류의 일(편집, 삽입, 이동, 풀기)은 한 규칙으로 한다. 3장의 공통 규칙이 그 규칙이다3장
키보드만으로 모두마우스로 할 수 있는 일은 모두 키로도 할 수 있다R-NFR-05
Vim의 손에 맞게키와 그 동작은 “Vim에서 그 키가 실제로 어떻게 움직이는가”를 먼저 본다. 다르게 만들 때는 이유를 적는다03-keymap, DR-0009
뷰 상태와 내용을 구분한다접고 펴기처럼 뷰 상태만 바꾸는 일은 내용을 바꾸지 않고, 잘못 눌러도 한 번 더 누르거나 실행 취소하면 돌아온다. 내용을 바꾸는 일은 실행 취소 한 번으로 되돌린다02-interaction-rules
화면은 다이어그램에게화면이 좁으면 툴바와 설정은 접어 두고 다이어그램에 자리를 준다. 필요할 때 버튼 하나로 편다MB1
막지 않고 알린다입력을 막는 자리를 늘리지 않는다. 할 수 없는 일은 아무 일도 하지 않고 이유를 알린다Q14-a

3. 공통 규칙

요구사항의 편집 규칙은 60개쯤이고 대부분 블록 종류마다 따로 적혀 있었습니다. 아래 일곱 개로 묶으면 그 가운데 절반쯤이 “공통 규칙을 따른다” 한 줄로 줄어듭니다. 질문마다의 결정과 이유는 ux-decisions에 있습니다.

#공통 규칙한 줄질문상태
R1편집텍스트가 있는 것은 모두 같은 방법으로 편집을 시작하고 끝낸다Q1, Q2, Q3정함 → Q1 · Q2, [[ux-decisions#Q3. Esc의 뜻 (R1)|Q3]]
R2빈 텍스트비울 수 없는 칸을 비우면 어디서나 같은 일이 일어난다Q4정함 → Q4
R3삽입 위치새로 생기는 것은 선택한 것 뒤에, Shift는 앞에Q5정함(분기도 같은 명령으로) → Q5
R4이동블록 · 분기 · 다이어그램의 순서를 명령 하나로 바꾼다Q6정함 → Q6
R5묶기와 풀기묶는 명령은 셋, 푸는 명령은 둘 (래퍼 풀기, 접기 영역 풀기)Q7, Q16, Q17정함 → Q7, Q16 · Q17
R6접기 · 펴기뷰 상태만 바꾸는 명령은 하나이고, 무엇에나 같은 식으로 적용된다Q8, Q11, Q13~Q15, Q20모두 정함. Q20은 2026-11-03 → Q8, Q11, FD1
R7실행 취소내용을 바꾸면 대상이고, 접고 펴기 · 펴 보기도 대상이다. 이름 띠 보기와 결과 기호는 대상이 아니다Q9, UN1정함 → UN1 (Q9를 대체)

4. 문서 지도

문서답하는 질문이런 때 읽는다
01-ux-overview (이 문서)누구를 위해, 어떤 원칙으로?처음 읽을 때
02-interaction-rules기능 하나하나가 어떻게 움직이나?”이걸 선택하고 이 명령을 쓰면?“
03-keymap어떤 키가 어떤 명령인가?”키는?“
04-visual-design어떻게 보이나? 색 · 선 · 타이포그래피 · 치수는?화면이나 저장되는 그림을 만들 때
05-screen-layout편집 화면에 무엇이 어디에 있나? 메뉴 바 · 툴바 · 캔버스 · 상태 표시줄화면의 배치를 볼 때
  • 한 항목은 한 문서에만 적는다. 조작 규칙에는 명령의 이름만 적고 키는 03-keymap에, 모습의 값은 04-visual-design에만 적는다.
  • 아직 정하지 않은 질문은 9. 미결정 사항에 있다. 정한 것의 이유는 아뜰리에의 UX 결정 모음에 있다.
  • 비교한 안과 장면 그림은 시안 페이지에 있다 → sketchbook

5. 어떻게 정했나

flowchart LR
    REQ["요구사항<br>(무엇을)"] --> UX["UX 설계<br>(어떤 조작과 모습으로)"]
    UX --> ED["상세 설계<br>(어떻게 만드나)"]
    UX -. "규칙이 다른 곳,<br>빠진 곳을 되돌려 줌" .-> REQ
    UX <-. "한 버전에 한 묶음씩<br>써 보고 정함" .-> PROTO["프로토타입"]
  • 공통 규칙은 요구사항에서 같은 일을 곳마다 다르게 다루는 곳을 모아 세웠다. 요구사항만 전달받은 다른 검토자(독립 검토)가 따로 읽어 비교했다 → requirements-rework
  • 질문은 프로토타입을 버전마다 써 보며 한 묶음씩 정한다 → 리뷰 순서
  • 문서를 나눈 방법의 비교한 안은 sketchbook의 “UX 문서 구조 시안”에 있다.