From ccc8704777a42a00dcb4a7d62fcbfa79702a8923 Mon Sep 17 00:00:00 2001 From: Brad King Date: Tue, 4 Feb 2014 10:28:12 -0500 Subject: Help: Add documents to collect notes between releases Add a release/dev.txt file and include it from release/index.rst in development versions. Add a "Changes Since Release" section with a toctree that globs adjacent "dev/*" documents. Add a sample topic document explaining how topic-specific release note documents work. This approach will allow developers to write release notes for their changes as they are made. The release manager may then consolidate and organize the notes for a specific release version. --- Help/release/dev.txt | 16 ++++++++++++++++ Help/release/dev/0-sample-topic.rst | 7 +++++++ Help/release/index.rst | 6 ++++++ 3 files changed, 29 insertions(+) create mode 100644 Help/release/dev.txt create mode 100644 Help/release/dev/0-sample-topic.rst diff --git a/Help/release/dev.txt b/Help/release/dev.txt new file mode 100644 index 0000000..2cf9193 --- /dev/null +++ b/Help/release/dev.txt @@ -0,0 +1,16 @@ +.. + This file should be included by the adjacent "index.rst" + in development versions but not in release versions. + +Changes Since Release +===================== + +The following noteworthy changes have been made in this development +version since the preceding release but have not yet been consolidated +into notes for a specific release version: + +.. toctree:: + :maxdepth: 1 + :glob: + + dev/* diff --git a/Help/release/dev/0-sample-topic.rst b/Help/release/dev/0-sample-topic.rst new file mode 100644 index 0000000..e4cc01e --- /dev/null +++ b/Help/release/dev/0-sample-topic.rst @@ -0,0 +1,7 @@ +0-sample-topic +-------------- + +* This is a sample release note for the change in a topic. + Developers should add similar notes for each topic branch + making a noteworthy change. Each document should be named + and titled to match the topic name to avoid merge conflicts. diff --git a/Help/release/index.rst b/Help/release/index.rst index 52fedc1..f8367d7 100644 --- a/Help/release/index.rst +++ b/Help/release/index.rst @@ -1,6 +1,12 @@ CMake Release Notes ******************* +.. + This file should include the adjacent "dev.txt" file + in development versions but not in release versions. + +.. include:: dev.txt + Releases ======== -- cgit v0.12