# 왜 안정 버전과 릴리스 노트가 일치하지 않나요?

**URL:** https://meta.discourse.org/t/why-dont-stable-versions-and-release-notes-match/165297
**Category:** Support
**Created:** [9월 25, 2020, 12:24오전 UTC](https://meta.discourse.org/t/why-dont-stable-versions-and-release-notes-match/165297 "2020-09-25T00:24:12Z")
**Posts on this page:** 11
**Page:** 1

<div class="post-metadata">

### Author: ![bquintrell](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/bquintrell/32/195183_2.png) [@bquintrell](https://meta.discourse.org/u/bquintrell)
#### Post date: [9월 25, 2020, 12:24오전 UTC](https://meta.discourse.org/t/why-dont-stable-versions-and-release-notes-match/165297/1 "2020-09-25T00:24:12Z")

</div>

OK - 궁금한 게 있었는데 물어보겠습니다…

Discourse 인스턴스에서 "새 버전"이 사용 가능하다는 이메일을 받고 있습니다.  
"릴리스 노트에서 새 내용을 확인하세요…"라는 링크가 있습니다.  
하지만 링크를 클릭하면 해당 새 버전과 그 릴리스 노트에 대한 언급이 전혀 없습니다.

여기 보세요 - 새 버전이 2.5.2라고 했는데, 링크로 연결되는 화면을 보면 2.5.2 릴리스 노트에 대한 언급이 보이나요?

결국 제 문제를 해결해 주기는커녕, 링크가 오히려 답답하게 만들었습니다.

저만 이런가요?

 ![image](https://global.discourse-cdn.com/meta/original/3X/c/c/cc0187d62e1cba842bf8f59b7ef33570f16089ca.png)

---

<div class="post-metadata">

### Author: ![codinghorror](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/codinghorror/32/110067_2.png) [@codinghorror](https://meta.discourse.org/u/codinghorror)
#### Post date: [9월 25, 2020, 1:22오전 UTC](https://meta.discourse.org/t/why-dont-stable-versions-and-release-notes-match/165297/3 "2020-09-25T01:22:15Z")

</div>

2.5.2는 안정 버전이며 변경 사항이 최소한이고, 새로운 버전들은 베타입니다.

---

<div class="post-metadata">

### Author: ![bquintrell](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/bquintrell/32/195183_2.png) [@bquintrell](https://meta.discourse.org/u/bquintrell)
#### Post date: [9월 25, 2020, 1:39오전 UTC](https://meta.discourse.org/t/why-dont-stable-versions-and-release-notes-match/165297/4 "2020-09-25T01:39:48Z")

</div>

감사합니다 - 하지만 우리가 같은 맥락에서 이야기하고 있는지 확인하고 싶어서요…  
링크는 2.5.2 릴리스 노트로 이동한다고 되어 있습니다. 하지만 실제로는 그렇지 않습니다. 해당 링크/페이지 어디에도 2.5.2 릴리스 노트에 대한 언급이 없습니다.  
지난 공지에서도 같은 일이 있었습니다.

---

<div class="post-metadata">

### Author: ![codinghorror](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/codinghorror/32/110067_2.png) [@codinghorror](https://meta.discourse.org/u/codinghorror)
#### Post date: [9월 25, 2020, 1:41오전 UTC](https://meta.discourse.org/t/why-dont-stable-versions-and-release-notes-match/165297/5 "2020-09-25T01:41:08Z")

</div>

안정판 업데이트는 보통 매우 사소한 변경 사항이거나, 절대적으로 필요한 백포트 버그 수정만 포함되기 때문에 릴리스 노트를 제공하지 않습니다. GitHub의 특수 링크를 통해 안정판 변경 사항을 확인할 수 있을지 모르겠고, @jomaxro님이 아이디어를 가지고 계실지도 모릅니다.

일반적으로 tests-passed를 유지하는 것을 권장하며, 저희 고객/호스팅 서비스 모두 tests-passed를 사용 중입니다.

---

<div class="post-metadata">

### Author: ![jomaxro](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/jomaxro/32/126216_2.png) [@jomaxro](https://meta.discourse.org/u/jomaxro)
#### Post date: [9월 25, 2020, 3:06오전 UTC](https://meta.discourse.org/t/why-dont-stable-versions-and-release-notes-match/165297/6 "2020-09-25T03:06:49Z")

</div>

Jeff가 맞습니다. 저는 안정 버전(stable release)에 대해 릴리스 노트를 작성하지 않습니다. 받으신 이메일은 모든 Discourse 인스턴스에서 공유되는 표준 이메일입니다. 해당 이메일은 어떤 브랜치를 사용 중인지 알 수 없습니다.

안정 점 버전(stable point release)에는 중요한 버그 수정과 보안 패치만 포함됩니다. 수백 가지 변경 사항이 포함된 일반 릴리스와 달리, 안정 점 릴리스에는 일반적으로 10개 미만의 변경 사항이 포함되어 있으며, 대부분은 그보다 훨씬 적습니다.

모든 변경 사항은 [https://github.com/discourse/discourse/commits/stable](https://github.com/discourse/discourse/commits/stable)에서 확인할 수 있습니다. "Version bump to v{현재 버전}"과 "Version bump to v{이전 버전}"을 찾아보세요. 이 두 항목 사이의 모든 것이 변경 사항입니다. v2.5.2의 경우 변경 사항이 7개 있습니다. 3개는 보안 관련, 2개는 보안 변경 사항에 대한 후속 조치, 2개는 중요한 성능 수정 사항입니다.

---

<div class="post-metadata">

### Author: ![bquintrell](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/bquintrell/32/195183_2.png) [@bquintrell](https://meta.discourse.org/u/bquintrell)
#### Post date: [9월 29, 2020, 7:32오후 UTC](https://meta.discourse.org/t/why-dont-stable-versions-and-release-notes-match/165297/7 "2020-09-29T19:32:10Z")

</div>

정리가 되었습니다. 안정판 릴리스에 대해 릴리스 노트를 작성하지 않는 이유에 대한 논리는 어느 정도 이해가 갑니다. 제 핵심 주장은, 우리 중 많은 사람들이 이메일 알림을 받고 있는데, 대부분의 경우 릴리스 노트 링크에 아무런 내용이 없다는 점입니다. 한 가지 대안은 템플릿을 변경하여 기대치를 더 잘 설정하는 것입니다. 그래야 제가 조롱받는 기분이 들며, 방금 받은 이메일과 관련 없는 내용을 확인하기 위해 클릭하는 일이 줄어들 것입니다.

만약 우리가 만든 제품이라면, 모든 릴리스에 대해 10분만 투자해 릴리스 노트를 작성했을 것입니다.  
그냥 "이것은 마이너 릴리스입니다. 리스크가 낮으며 주로 버그 수정입니다. 다만 xxx 처리 방식을 변경했으니, 해당 개선 사항이나 잠재적 영향에 대해 알고 싶으시다면 참고해 주세요."라고 간단히 적는 정도면 됩니다.

어쨌든 - 저는 괜찮습니다.

---

<div class="post-metadata">

### Author: ![bquintrell](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/bquintrell/32/195183_2.png) [@bquintrell](https://meta.discourse.org/u/bquintrell)
#### Post date: [6월 4, 2021, 9:15오후 UTC](https://meta.discourse.org/t/why-dont-stable-versions-and-release-notes-match/165297/8 "2021-06-04T21:15:35Z")

</div>

표준 버전 업데이트 이메일 템플릿을 수정할 것을 제안합니다:

다음 문구  
"[**릴리스 노트**](https://meta.discourse.org/tag/release-notes)에서 새로운 내용을 확인하세요"  
를  
“이 버전에는 릴리스 노트가 없으므로, 이 [**릴리스 노트**](https://meta.discourse.org/tag/release-notes)를 뒤져서 이 새 버전의 내용을 직접 찾아보세요”  
로 변경하세요.

배경  
오늘도 2.7.1 버전이 사용 가능하다는 이메일을 받았는데, 제공된 릴리스 노트 링크에는 2.7.1에 대한 노트가 포함되어 있지 않았습니다. 링크는 도움이 되거나, 아예 생략되어야 합니다.

---

<div class="post-metadata">

### Author: ![jomaxro](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/jomaxro/32/126216_2.png) [@jomaxro](https://meta.discourse.org/u/jomaxro)
#### Post date: [6월 7, 2021, 2:26오후 UTC](https://meta.discourse.org/t/why-dont-stable-versions-and-release-notes-match/165297/12 "2021-06-07T14:26:18Z")

</div>

빌 씨,

내부에서 논의를 거쳤습니다. 제안하신 대로 카피를 변경하는 것은 어렵다는 점, 이해해 주실 거라 생각합니다. 기본적으로 tests-passed를 유지하는 것을 여전히 권장하되, 앞으로는 안정 버전(stable release)에 대해 릴리스 노트를 작성할 예정입니다. 참고로 안정 버전은 중요한 버그 수정과 보안 패치만 포함되기 때문에, 일반 릴리스 노트와 동일한 수준의 상세 정보가 포함되지 않습니다.

---

<div class="post-metadata">

### Author: ![bquintrell](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/bquintrell/32/195183_2.png) [@bquintrell](https://meta.discourse.org/u/bquintrell)
#### Post date: [6월 7, 2021, 4:08오후 UTC](https://meta.discourse.org/t/why-dont-stable-versions-and-release-notes-match/165297/13 "2021-06-07T16:08:48Z")

</div>

매우 좋습니다. 비꼬는 말투를 해서 죄송합니다. 하지만 새 릴리스 알림을 받으면, 해당 릴리스가 사용자에게 어떤 영향을 미치고 업그레이드의 우선순위가 얼마나 높은지 확인하기 위해 링크를 바로 클릭하고 싶어집니다.  
하지만 링크가 그렇게 해 주지 않아 늘 실망스럽습니다. 대부분의 경우, 업그레이드에서 참조되는 것과 동일한 버전 번호를 가진 문서가 존재하지 않습니다. 그래서 이제 해당 릴리스에 특화된 문서를 찾는 데 얼마나 많은 시간을 투자해야 할지 스스로 결정해야 합니다. 분명히 "beta"나 이전 릴리스 번호가 포함된 문서는 최종 릴리스와 상당히 다를 수 있으므로, 그런 문서는 저에게 도움이 되지 않습니다.

이 문제를 앞으로 나아가게 해 주셔서 감사합니다.

---

<div class="post-metadata">

### Author: ![riking](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/riking/32/170938_2.png) [@riking](https://meta.discourse.org/u/riking)
#### Post date: [6월 7, 2021, 7:42오후 UTC](https://meta.discourse.org/t/why-dont-stable-versions-and-release-notes-match/165297/14 "2021-06-07T19:42:13Z")

</div>

향후 참고용으로, 2.5.0과 같은 주요 안정판 버전 업데이트의 실제 변경 이력은 해당 버전으로 시작하는 모든 베타 릴리스(2.5.0.beta[1,2,3,4,5,6,7])의 합산입니다. 우리는 ‘베타’ 버전이 항상 사용 가능하도록 유지하는 데 주력하며, ‘안정판’ 분기는 \_버그의 부재\_보다 \_변경 사항의 부재\_에 더 중점을 둡니다.

패치 릴리스 노트가 이러한 혼란을 해소하는 데 도움이 되기를 바랍니다.

---

<div class="post-metadata">

### Author: ![jomaxro](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/jomaxro/32/126216_2.png) [@jomaxro](https://meta.discourse.org/u/jomaxro)
#### Post date: [6월 8, 2021, 4:31오후 UTC](https://meta.discourse.org/t/why-dont-stable-versions-and-release-notes-match/165297/15 "2021-06-08T16:31:43Z")

</div>

마지막 2개의 안정화 패치에 대한 릴리스 노트가 공개되었습니다.
