2015-07-12 04:04:52 +00:00
|
|
|
<!-- BEGIN MUNGE: UNVERSIONED_WARNING -->
|
|
|
|
|
|
|
|
<!-- BEGIN STRIP_FOR_RELEASE -->
|
|
|
|
|
2015-07-16 17:02:26 +00:00
|
|
|
<img src="http://kubernetes.io/img/warning.png" alt="WARNING"
|
|
|
|
width="25" height="25">
|
|
|
|
<img src="http://kubernetes.io/img/warning.png" alt="WARNING"
|
|
|
|
width="25" height="25">
|
|
|
|
<img src="http://kubernetes.io/img/warning.png" alt="WARNING"
|
|
|
|
width="25" height="25">
|
|
|
|
<img src="http://kubernetes.io/img/warning.png" alt="WARNING"
|
|
|
|
width="25" height="25">
|
|
|
|
<img src="http://kubernetes.io/img/warning.png" alt="WARNING"
|
|
|
|
width="25" height="25">
|
|
|
|
|
|
|
|
<h2>PLEASE NOTE: This document applies to the HEAD of the source tree</h2>
|
|
|
|
|
|
|
|
If you are using a released version of Kubernetes, you should
|
|
|
|
refer to the docs that go with that version.
|
|
|
|
|
|
|
|
<strong>
|
|
|
|
The latest 1.0.x release of this document can be found
|
|
|
|
[here](http://releases.k8s.io/release-1.0/docs/devel/making-release-notes.md).
|
|
|
|
|
|
|
|
Documentation for other releases can be found at
|
|
|
|
[releases.k8s.io](http://releases.k8s.io).
|
|
|
|
</strong>
|
|
|
|
--
|
2015-07-13 22:15:35 +00:00
|
|
|
|
2015-07-12 04:04:52 +00:00
|
|
|
<!-- END STRIP_FOR_RELEASE -->
|
|
|
|
|
|
|
|
<!-- END MUNGE: UNVERSIONED_WARNING -->
|
2015-05-01 06:49:39 +00:00
|
|
|
## Making release notes
|
|
|
|
This documents the process for making release notes for a release.
|
|
|
|
|
|
|
|
### 1) Note the PR number of the previous release
|
2015-07-07 23:29:18 +00:00
|
|
|
Find the most-recent PR that was merged with the previous .0 release. Remember this as $LASTPR.
|
2015-05-01 06:49:39 +00:00
|
|
|
_TODO_: Figure out a way to record this somewhere to save the next release engineer time.
|
|
|
|
|
2015-07-07 23:29:18 +00:00
|
|
|
Find the most-recent PR that was merged with the current .0 release. Remeber this as $CURRENTPR.
|
|
|
|
|
|
|
|
### 2) Run the release-notes tool
|
2015-05-01 06:49:39 +00:00
|
|
|
```bash
|
2015-07-07 23:29:18 +00:00
|
|
|
${KUBERNETES_ROOT}/build/make-release-notes.sh $LASTPR $CURRENTPR
|
2015-05-01 06:49:39 +00:00
|
|
|
```
|
|
|
|
|
|
|
|
### 3) Trim the release notes
|
2015-07-07 23:29:18 +00:00
|
|
|
This generates a list of the entire set of PRs merged since the last minor
|
|
|
|
release. It is likely long and many PRs aren't worth mentioning. If any of the
|
|
|
|
PRs were cherrypicked into patches on the last minor release, you should exclude
|
|
|
|
them from the current release's notes.
|
2015-05-01 06:49:39 +00:00
|
|
|
|
|
|
|
Open up ```candidate-notes.md``` in your favorite editor.
|
|
|
|
|
|
|
|
Remove, regroup, organize to your hearts content.
|
|
|
|
|
|
|
|
|
|
|
|
### 4) Update CHANGELOG.md
|
|
|
|
With the final markdown all set, cut and paste it to the top of ```CHANGELOG.md```
|
|
|
|
|
|
|
|
### 5) Update the Release page
|
|
|
|
* Switch to the [releases](https://github.com/GoogleCloudPlatform/kubernetes/releases) page.
|
|
|
|
* Open up the release you are working on.
|
|
|
|
* Cut and paste the final markdown from above into the release notes
|
|
|
|
* Press Save.
|
|
|
|
|
2015-05-14 22:12:45 +00:00
|
|
|
|
2015-07-14 00:13:09 +00:00
|
|
|
<!-- BEGIN MUNGE: GENERATED_ANALYTICS -->
|
2015-06-19 16:59:27 +00:00
|
|
|
[![Analytics](https://kubernetes-site.appspot.com/UA-36037335-10/GitHub/docs/devel/making-release-notes.md?pixel)]()
|
2015-07-14 00:13:09 +00:00
|
|
|
<!-- END MUNGE: GENERATED_ANALYTICS -->
|