엔지니어링
빌드 산출물로서의 changelog: 규칙, 자동화, 파이프라인.
여기서 시작하세요: Keep a Changelog 설명과 CHANGELOG.md 템플릿, Conventional commits에서 체인지로그로, 체인지로그 자동화: 무엇을 자동화하고 무엇을 하지 말까
-
핫픽스란? 뜻, 핫픽스와 패치의 차이, 안전한 배포
핫픽스는 정규 릴리스 주기 밖에서 내보내는 긴급 수정이다. 용어의 뜻, 패치나 버그 수정과의 차이, 핫픽스를 안전하게 배포하는 방법을 정리했다.
엔지니어링5분 분량
-
릴리스 후보(RC): 의미와 운영하는 방법
릴리스 후보는 테스트에서 차단 문제가 나오지 않으면 최종 버전으로 나가는 빌드다. 베타 다음의 위치, 버전 표기, 종료 기준을 정리했다.
엔지니어링4분 분량
-
CHANGELOG.md에는 무엇을 쓰고 어떻게 최신으로 유지하는가
CHANGELOG.md는 버전마다 무엇이 바뀌었는지 독자에게 보여주는 기록이다. 필요한 절, 완전한 예시, 그리고 파일을 최신으로 유지하는 습관 하나를 정리했다.
엔지니어링4분 분량
-
GitHub 릴리스 노트, 자동 생성한 뒤 읽히게 다듬는 법
GitHub는 병합된 pull request로 릴리스 노트 초안을 한 번에 만든다. 초안에 담기는 것, release.yml의 역할, 읽히게 만드는 편집 과정을 정리했다.
엔지니어링5분 분량
-
자주 배포하는 팀을 위한 릴리스 관리 프로세스
소프트웨어 팀을 위한 릴리스 관리 프로세스를 범위 계획부터 회고까지 일곱 단계로 나누고, 단계마다 담당자와 완료 기준을 정했다. DORA 지표도 소개한다.
엔지니어링6분 분량
-
체인지로그는 누가 쓰는가, 그리고 누가 써야 하는가
체인지로그는 누가 쓰는가? PR 작성자는 무엇이 바뀌었는지 알고 PM은 왜 중요한지 안다. 어느 쪽도 혼자서는 쓸모 있는 항목을 쓸 수 없다.
엔지니어링4분 분량
-
체인지로그 파일 형식, JSON인가 YAML인가 그냥 Markdown인가
체인지로그 파일의 형식은 페이지와 위젯을 공급할 수 있는지 사람만 읽는지를 정한다. Markdown, JSON, YAML이 각각 치르는 대가를 비교한다.
엔지니어링4분 분량
-
GitHub Actions로 체인지로그 항목 필수화하기
GitHub Actions 체인지로그 체크는 항목 없는 머지를 막는다. 기억에 의존하면 일정 앞에서 실패하는 이유와 체크 자체가 깨뜨리는 것을 다룬다.
엔지니어링4분 분량
-
Git 태그 vs GitHub 릴리스 vs 체인지로그
Git 태그, 릴리스, 체인지로그 항목은 하나의 사건에 대한 세 가지 기록이다. 이를 혼동하면 체인지로그가 실제 릴리스에서 벗어난다. 맞추는 법을 설명한다.
엔지니어링4분 분량
-
모노레포 체인지로그: 하나로 합칠까, 패키지마다 따로 둘까
모노레포는 저장소 전체를 위한 체인지로그 하나나 패키지마다 하나를 둘 수 있다. 잘못 고르면 릴리스가 너무 시끄럽거나 흩어진다. 기준은 구조가 아니라 독자다.
엔지니어링4분 분량
-
시맨틱 버저닝과 체인지로그: 버전 상승의 의미
시맨틱 버저닝은 호출자가 체인지로그 항목을 읽기 전에 릴리스가 얼마나 아플지 알려준다. 각 숫자가 약속하는 것과 항목이 그에 대해 져야 할 책임을 설명한다.
엔지니어링4분 분량
-
공개 체인지로그 페이지: 구독하고 싶게 만드는 법
체인지로그 페이지는 사람들이 다시 돌아올 때 가치가 있다. 어디에 둘지, 항목에 무엇이 필요한지, 피드와 마크업, 위젯과의 관계를 설명한다.
엔지니어링5분 분량
-
체인지로그 자동화: 무엇을 자동화하고 무엇을 하지 말까
수집, 포맷팅, 발행은 자동화해도 좋지만 무엇을 선별하고 어떻게 쓸지는 자동화해선 안 된다. 그 경계선이 어디인지, 옮겨지면 어떻게 되는지 살펴본다.
엔지니어링5분 분량
-
Conventional commits에서 체인지로그로
Conventional commits는 체인지로그를 도출 가능하게 하지만 읽기 쉽게 만들지는 못한다. 이 관례가 사주는 것과 한계, 그 간극을 메우는 법을 살펴본다.
엔지니어링5분 분량
-
Keep a Changelog 설명과 CHANGELOG.md 템플릿
Keep a Changelog 명세는 한 페이지이고 읽는 데 십 분도 걸리지 않지만, 구현하면서 대부분의 팀이 어긋난다. 명세가 말하는 것과 열어둔 것, 틀린 곳을 살펴본다.
엔지니어링4분 분량