버전 번호가 성격을 말해 줬다

회귀 테스트 문서의 첫 시트가 버전별 적용 사항이었다. 3.9.3부터 4.9.2까지 마흔 개 남짓이 늘어서 있다.

Table of contents

상황 — 마흔 개 남짓의 버전 이력

시트의 열 구성은 이렇다.

버전 · 한쪽 OS 내용 · 다른 쪽 OS 내용 · 티켓 · 비고

버전은 세 자리다.

4.9.2
4.9.1
4.9.0
4.8.6
4.8.5

버전 열의 어느 자리가 올랐는지와 그 옆의 내용 을 함께 놓고 읽어 볼 수 있다.

마흔 줄이 한 시트에 있으니 한 판씩 볼 때는 안 보이던 것이 보인다. 4.9.2 부터 3.9.3 까지 같은 자리가 오른 줄끼리 모으면 내용의 성격이 갈린다.

마지막 자리는 전부 긴급이었다

마지막 자리만 오른 버전들의 내용이 이렇다.

4.7.6  긴급 업데이트
       ㄴ 상세 화면 스크롤 시 이미지 노출 안 되는 이슈
       ㄴ 외부 공유 게시글에서 진입 시 앱 크래시 이슈

4.7.1  긴급 업데이트
       ㄴ 최근 검색어 삭제 후 재진입 시 삭제된 검색어 노출 이슈
       ㄴ 자동완성 목록 생성 시 크래시 이슈

4.5.1  긴급 업데이트
       ㄴ 이전 버전 크래시 이슈 수정

셋 다 긴급 업데이트 로 시작하고 내용이 전부 버그다.

계획에 있던 것이 아니라 나가고 나서 생긴 일에 대응한 판이라는 뜻이다. 4.7.6 과 4.5.1 처럼 마지막 자리 하나에 그 성격이 드러나 있다.

가운데 자리는 기능 묶음이다

가운데가 오른 버전은 모양이 다르다.

4.8.0  기능 다섯 개
4.7.0  기능 다섯 개
4.6.0  기능 여섯 개 + 마이너 다수
4.5.0  기능 여섯 개
4.4.0  기능 네 개

4.8.0 부터 4.4.0 까지 한 판에 기능이 넷에서 여섯 개씩 묶여 있다.

정리하면 규칙이 이렇게 보인다.

가운데 자리 ↑   기능 묶음
마지막 자리 ↑   버그 수정 또는 소규모

문서 어디에도 이 규칙이 적혀 있지 않은데 마흔 줄을 훑으니 저절로 드러났다. Semantic Versioning 이 MINOR 와 PATCH 에 붙여 둔 뜻과 같은 모양이어서 선언하지 않았어도 번호 자체가 정보를 담고 있었다.

배경 — 앱은 고쳐도 바로 안 퍼진다

긴급 업데이트 사유를 모으면 크래시가 자주 나온다.

공유 게시글에서 진입 시 크래시
자동완성 목록 생성 시 크래시
이전 버전 크래시

이것이 왜 긴급 업데이트 로 분류되는지도 같은 자료에서 읽힌다.

[웹]   고치면 다음 접속부터 적용
[앱]   스토어 심사 + 사용자 업데이트

앱은 고쳐도 사용자가 새 판을 내려받아야 반영된다.

그동안 문제가 있는 판이 계속 돌고 크래시가 나면 그 사용자는 앱을 아예 못 쓴다. 고치는 시점과 퍼지는 시점 사이가 벌어져 있어서 나가는 순간의 무게가 서버 쪽보다 크다.

제약 — 티켓이 없는 구간

버전별 항목 수도 편차가 크다.

4.8.5   한쪽 OS 항목 열두 개
4.7.1   한쪽만 두 개
4.0.2   한 줄

티켓 번호 열을 보면 채워진 구간과 빈 구간이 갈린다.

없음   4.0.x 이하
있음   4.1.0 이상

어느 시점부터 붙기 시작했고 이슈 추적을 그때 쓰기 시작한 것으로 보인다.

티켓 이 있으면 무엇을 왜 고쳤는지 그 번호로 따라갈 수 있다. 없는 구간은 이 표의 한 줄이 남은 전부다.

4.0.2  - 일부버그 수정.

어떤 버그였는지는 이 줄로 알 수 없다.

그래도 버전이 있었다는 것과 대략 무엇을 했는지는 남아 있다. 도구를 쓰기 전 것을 지금 소급해 채우기는 어려우니 기록의 밀도가 시기마다 다른 것은 받아들일 수밖에 없다.

표기 — 한 칸 안의 계층과 정렬

내용 칸에는 하위 항목이 함께 들어 있는 줄도 있다.

- 검색개편. (인기검색어, 최근검색어, 자동완성, 대체 검색어, 카테고리변경)
- 기획전메뉴 추가.
- 기타사항.
  ㄴ 푸시알림시 사운드 삽입.
  ㄴ 90일 이상 비밀번호 변경팝업 기본값 변경.
  ㄴ 구매 시 파라미터 오류 수정.

- 와 ㄴ 두 문자로 두 단계를 표현하고 있다.

표에서 계층을 담으려면 선택지가 둘이다.

[행을 나누면]  버전 열이 반복됨
[한 칸에]      계층 표기가 필요

한 칸에 넣는 쪽을 골랐고 그래서 들여쓰기를 ㄴ 같은 문자로 대신하게 된 것이다.

두 단계까지는 읽는 데 문제가 없다. 세 단계가 되면 문자를 하나 더 정해야 하고 무엇이 무엇에 딸린 것인지가 흐려질 것 같다.

정렬은 4.9.2 가 맨 위이고 3.9.3 이 맨 아래다. 지금 버전이 무엇이고 무엇이 바뀌었는지가 이 문서에서 가장 자주 나오는 물음이니 최신이 위인 편이 맞아 보인다.

정리

• 버전 세 자리 중 어느 자리가 올랐는지로 성격이 드러난다
• 마지막 자리는 버그 수정이고 가운데는 기능 묶음이다
• 문서에 안 적혀 있어도 마흔 줄을 모아 보면 규칙이 드러난다
• 규칙이 지켜지면 번호 자체가 정보를 담는다
• 앱은 고쳐도 바로 안 퍼져서 크래시가 긴급이 된다
• 고치는 시점과 퍼지는 시점 사이가 벌어져 있다
• 티켓 번호가 4.1.0부터 붙어 있다
• 그 전 구간은 표 한 줄이 전부이고 소급해 채우기는 어렵다
• 표 한 칸에 목록을 넣으면 계층을 문자로 표현하게 된다
• 두 단계까지는 읽히고 더 깊어지면 행을 나누는 편이 나아 보인다
• 자주 보는 물음에 맞춰 최신을 위에 둔다