Skip to content

v0.32.0

Choose a tag to compare

@jasonjung-creator jasonjung-creator released this 16 Sep 07:23
· 33 commits to main since this release

같은 정의서를 두 독자가 읽는다. 상위기획은 개발·디자인이 일감을 추산하고 기획이 「왜 그렇게 정했나」를 남기는 문서라 갈림길이었던 항목만 필요하고, 상세기획은 개발이 그대로 구현하고 QA 가 그대로 시험하는 문서라 전부 필요하다.
그런데 내보내기는 「화면 위 번호」 켬/끔 하나라 전부 아니면 전무였다. PM 실측(입주사 어드민 방문자 현황): 마커 32개 중 상위기획이 설명하는 것은 9개. 그림과 본문이 1:1 이 아니어서 독자가 「나머지 23개는 어디 설명이 있나」를 묻게 됐다 (#106).

항목에 「주요」 를 찍는다 (#106)

  • 항목에 major: true — 화면정의서 모드에서 제목 줄 오른쪽(×의 왼쪽)에 「주요」 단추. 꺼진 것은 올렸을 때만 나오고, 켜진 것은 늘 보인다 — 그때는 단추가 아니라 «표시» 로 읽혀야 한다
  • 내보내기에 「주요 항목만 (상위기획용)」 — 「화면 위 번호」 의 하위. 켜면 그림의 번호와 「기능 설명 표」 를 둘 다 그 항목만 남긴다. 그림은 걸렀는데 표에 전부 남으면 이슈가 호소한 «1:1 아님» 이 그대로다
  • 번호는 문서 전체 기준을 지킨다. 주요 항목이 1·3·4 면 그림에도 1 · 3 · 4 로 건너뛰어 박힌다. 다시 매기면 상위기획의 4번과 상세기획의 4번이 다른 것을 가리켜 번호로 대조할 수 없다
  • layer 와 직교하는 축이다. layer 는 「누가 쓰나」(기획↔개발), major 는 「어느 깊이인가」. 같은 기획 줄이라도 하나는 상위기획에 오르고 하나는 안 오르므로 layer 값을 늘려서는 안 풀린다
  • 이름을 brief 로 하지 않은 이유: 「화면 개요」(#82)가 안에서 이미 그 이름이다. 다른 것에 같은 이름을 쓰면 반드시 섞인다

찍힌 항목이 하나도 없으면 선택지가 아예 안 나온다 — 켜면 백지가 나오는 선택지는 만들지 않는다(「개발 정의 포함」 과 같은 규칙). 다만 개발 정의와 달리 「주요」 는 문서가 부팅 뒤에도 만들므로, 만들 때 한 번 재고 마는 것이 아니라 열 때마다 다시 본다.

하위 호환 — major 를 안 쓴 문서는 저장해도 키가 안 생기고 화면도 한 픽셀 안 바뀐다.

번호 없는 섹션 (#107)

화면마다 「메뉴 권한」처럼 화면 위를 가리키지 않는 항목을 두는 팀이 있다. 방법이 anno:"overview" 하나뿐이라 두 가지가 걸렸다 — 번호 칸에 늘 「개요」가 찍히고(화면 하나에 「개요」 둘), inOrder 가 맨 위로 끌어올린다. 번호 항목으로 두면 마커 없는 번호가 되어 화면 위 첫 번호가 3부터 시작하고, 매번 「못 찾은 정의」 경고까지 난다.

  • anno:"section" — 마커도 번호도 없는 것은 개요와 같고, 나머지는 반대다: 제 자리에, 제 이름으로 선다. 개요의 두 성질(라벨 고정·맨 위)은 #82 의 «결정»이라 옵션으로 열지 않고 다른 이름을 뒀다
  • 번호가 곧 열쇠였다. 행 id·드래그·찾기가 전부 String(s.n) 이라, 섹션에는 파일에 안 남는 실행 시 열쇠를 준다. 다시 매길 때 섹션은 번호를 받지 않는다
  • 내보내기 표에도 번호 없이 «섹션» 으로 선다. 슬래시 / → 「섹션」 은 부른 항목 다음에 놓는다

곁들여 — 코드로 만든 설정의 빈 번호. 편집기는 옮기거나 지울 때 다시 매기지만 window.SCREENSPEC 에 직접 넣는 설정에는 손이 닿지 않아, 번호가 비어도 아무 신호가 없었다(이슈 제기자 실측 2화면). 고치지 않고 말만 한다 — 로드 때 우리가 매기면 그쪽 문서와 화면의 번호가 어긋난다(번호는 문서 기준, #106 과 같은 이유). 화면마다 콘솔 한 줄: 빈 번호·겹친 번호·있는 번호.

시험이 잡은 것

  • wrap 모드에서 살아 있는 시트의 번호를 지우고 있었다. wrap 은 시트를 상자로 «옮겼다 되돌리는» 길이라, 거기서 마커를 떼어내면 뽑고 난 뒤 화면에서 번호가 사라진다 — 떼어낸 노드는 마커 자리잡기가 되살릴 수 없다. 지우는 대신 숨긴다(숨긴 것은 자리잡기가 제 손으로 되돌린다). 「뽑고 나면 화면의 번호는 전부 돌아온다」 검사와 돌연변이가 이를 지킨다
  • 숨긴 마커는 그림 둘레 여백 계산에서도 뺀다 — 안 그러면 display:none 의 좌표(0,0)가 «튀어나온 만큼» 으로 잡혀 왼쪽에 흰 띠가 생긴다