릴리스 노트에서 반드시 확인해야 할 항목

이런 상황일 때

업데이트 하나에 릴리스 노트가 화면 몇 장 분량입니다. 영어이고, 대부분은 제가 쓰지도 않는 기능 이야기입니다. 다 읽자니 시간이 없고 안 읽자니 뭔가 놓칠 것 같습니다.

한 줄 결론

다 읽지 않아도 됩니다. 먼저 릴리스 간격을 보고, 그 다음 네 가지만 찾으세요 — 깨지는 변경 · 보안 수정 · 데이터 이전 · 요구사항 변경. 나머지는 필요할 때 돌아와서 읽으면 됩니다.

핵심 개념

먼저 볼 것은 본문이 아니라 간격

이 판이 평소보다 얼마나 빨리 나왔는가를 먼저 봅니다. 한 달에 한 번 내던 프로그램이 사흘 만에 또 냈다면, 본문을 읽기 전에 이미 급한 수정이라는 뜻입니다. 이 사이트는 제품마다 평소 간격을 계산해 둡니다.

① 깨지는 변경 (breaking change)

쓰던 방식이 더 이상 통하지 않게 되는 변경입니다. breaking, 주의, 이전 안내 같은 말로 표시되며 대개 맨 앞이나 별도 항목에 모여 있습니다.

② 보안 수정

security, CVE, 취약점 같은 말을 찾습니다. 없다고 보안 수정이 없는 것은 아니지만, 있으면 확실합니다.

③ 데이터 이전 (migration)

저장 형식이 바뀌어 한 번 변환이 일어나는 경우입니다. 이게 있으면 되돌리기가 어려워집니다. migration, schema, 업그레이드 안내 같은 말을 찾습니다.

④ 요구사항 변경

더 높은 판의 다른 프로그램을 요구하게 되는 경우입니다. requires, minimum, 최소 사양 같은 말을 찾습니다. 이걸 놓치면 올리고 나서 켜지지 않습니다.

이런 분에게 해당됩니다

• 영어 릴리스 노트를 매번 다 읽기 어려운 분
• 여러 프로그램의 업데이트를 한꺼번에 판단해야 하는 분
• 업데이트 뒤에 무언가 안 돼서 원인을 찾아본 적이 있는 분

확인해야 할 항목

• 이 판이 평소 간격보다 빨리 나왔는가
• breaking 또는 주의 표시가 있는가
• security 또는 CVE 표기가 있는가
• 데이터 이전(migration)이 일어나는가
• 요구하는 다른 프로그램의 최소 판이 올라갔는가
• “알려진 문제” 항목이 따로 있는가

잘못 이해하기 쉬운 부분

안전한 행동 순서

1. 이 프로그램의 평소 릴리스 간격을 확인합니다.
2. 노트를 위에서 아래로 읽지 말고, 네 가지 표현을 검색합니다 — breaking · security · migration · require.
3. 건너뛰는 판이 있다면 그 판들의 노트에서도 같은 것을 찾습니다.
4. “알려진 문제” 항목이 있으면 마지막에 읽습니다.
5. 네 가지 중 하나라도 걸리면 그때 본문을 자세히 읽습니다.
6. 아무것도 안 걸리면 대개 그대로 올려도 됩니다.

확인 체크리스트

• 평소 릴리스 간격과 견줘 봤다
• breaking 표기를 찾아봤다
• security·CVE 표기를 찾아봤다
• 데이터 이전이 있는지 확인했다
• 요구사항이 올라갔는지 확인했다
• 건너뛰는 판의 노트도 같은 방식으로 훑었다

관련 도구와 버전 페이지

• 릴리스 이력과 간격
  카테고리별 버전 페이지에 제품마다 최근 릴리스와 평소 간격이 정리돼 있습니다. “이번 판이 평소보다 빨랐는가”를 여기서 볼 수 있습니다.
• 릴리스 노트 본문 보관 — 아직 제공하지 않습니다
  이 사이트는 릴리스 노트 본문을 저장하지 않습니다. 길이가 들쭉날쭉하고 외부에서 온 글이기 때문입니다. 본문은 각 제품의 공식 릴리스 페이지에서 읽으셔야 합니다.

자주 묻는 것

릴리스 노트가 커밋 목록뿐입니다.

그때는 커밋 메시지에서 같은 네 가지 표현을 찾습니다. fix, security, migrate, bump 정도가 단서가 됩니다. 그리고 릴리스 간격이 더 중요한 신호가 됩니다.

“알려진 문제”가 적혀 있으면 올리지 말아야 하나요?

적혀 있다는 것 자체는 좋은 신호입니다 — 숨기지 않는다는 뜻이니까요. 그 문제가 내가 쓰는 기능에 걸리는지만 보시면 됩니다.

평소 간격을 어떻게 아나요?

이 사이트의 카테고리별 버전 페이지에 제품마다 계산해 두었습니다. 직접 보시려면 저장소의 릴리스 목록에서 최근 몇 개의 날짜 간격을 보시면 됩니다.