Ceph » Stable releases

* git clone -b release (for instance git clone -b dumpling http://github.com/ceph/ceph)

* run the following to get a base to work on

<pre>

#!/usr/bin/env python

import re

# Needs https://github.com/gitpython-developers/GitPython, pip install gitpython

from git import Repo

repo = Repo('.')

active_branch = repo.active_branch.name

print "active_branch: " + active_branch

print

print "-" * 10

print

version_pattern = re.compile("\d+\.\d+(\.\d+)?")

signed_off_pattern = re.compile("Signed-off-by: (.+) <")

fixes_pattern = re.compile("Fixes: (#\d+(, #\d+)*)")

found = 0

def to_line(commit):

    return "* `{0}<http://github.com/ceph/ceph/commit/{1}>`_".format(commit.summary, str(commit))

# List all commits in Git log up to the latest 0.mm.nn tag

for commit in list(repo.iter_commits(active_branch)):

    if version_pattern.match(commit.summary):

        break

    else:

        line = to_line(commit)

        fixes = ["`#{0}<http://tracker.ceph.com/issues/{0}>`_".format(issue_number[1:])

            for sublist in fixes_pattern.finditer(commit.message)

            for issue_number in sublist.group(1).split(", ")

        ]

        signers = signed_off_pattern.findall(commit.message)

        if signers:

            fixes.append(", ".join(signers))

        if fixes or signers:

            line = line + " (" + " ".join(fixes) + ")"

            print line

            print

            found += 1

print

print "-" * 10

print

print "Found {0} commits matching \"Fixes:\" or \"Signed-off-by:\"".format(found)

</pre>

* manual edit the list of commits

* add a section in http://docs.ceph.com/docs/master/release-notes/ in the *master* branch of ceph in the "release-notes.rst":https://github.com/ceph/ceph/blob/master/doc/release-notes.rst file with the list of commits

* backport the release notes to the release branch when they are final. Ideally this is done before the point release is published. If not it can be backported shortly afterwards.

* add the release to the "timeline":https://github.com/ceph/ceph/blob/master/doc/release.rst

* the release notes come with an introduction that "is prepared in a separate file":https://github.com/ceph/ceph/blob/master/PendingReleaseNotes . It can be edited if something significant must not be forgotten and it does not need to well written because it is a draft.