summaryrefslogtreecommitdiffstats
path: root/wiki/src/contribute/how/documentation/release_notes.mdwn
diff options
context:
space:
mode:
Diffstat (limited to 'wiki/src/contribute/how/documentation/release_notes.mdwn')
-rw-r--r--wiki/src/contribute/how/documentation/release_notes.mdwn31
1 files changed, 19 insertions, 12 deletions
diff --git a/wiki/src/contribute/how/documentation/release_notes.mdwn b/wiki/src/contribute/how/documentation/release_notes.mdwn
index 32ffe7d..4e56366 100644
--- a/wiki/src/contribute/how/documentation/release_notes.mdwn
+++ b/wiki/src/contribute/how/documentation/release_notes.mdwn
@@ -2,31 +2,38 @@
- Create a branch based on the development branch for this release
- `web/nnnnn-x.y-release-notes`
- - Copy template form contribute/how/documentation/release_notes/template.mdwn to news/version_x.y.mdwn
+ - Copy template from `contribute/how/documentation/release_notes/template.mdwn` to `news/version_x.y.mdwn`
+ - Replace placeholders in template
- Gather information about changes
- Tails changelog
- <https://git-tails.immerda.ch/tails/tree/debian/changelog?h=stable>
- - <https://git-tails.immerda.ch/tails/tree/debian/changelog?h=devel>
+ - <https://git-tails.immerda.ch/tails/tree/debian/changelog?h=testing>
- If a release candidate was announced, read the call for testing
- Analyze the changes already made on the website and link to them:
- - in testing for a major release: `git diff origin/master...origin/testing wiki/src`
- - in stable for a minor release: `git diff origin/master...origin/stable wiki/src`
+ - in testing for a major release: `git diff origin/master...origin/testing wiki/src/**/*.{mdwn,html}`
+ - in stable for a minor release: `git diff origin/master...origin/stable wiki/src/**/*.{mdwn,html}`
- Analyze the Redmine view for this release
- Analyze the diff of packages
- in testing for a major release: `wget http://nightly.tails.boum.org/build_Tails_ISO_testing/lastSuccessful/archive/latest.iso.packages`
- in stable for a minor release: `wget http://nightly.tails.boum.org/build_Tails_ISO_stable/lastSuccessful/archive/latest.iso.packages`
- `diff -u ~/Persistent/master/wiki/src/torrents/files/tails-i386-*.packages latest.iso.packages | wdiff --diff-input --terminal`
- Read the Changelog of other updated software (Tor, I2P, etc.) to find relevant highlights
- - <https://blog.torproject.org/>
- - <https://gitweb.torproject.org/tor.git/tree/ChangeLog>
- - <https://gitweb.torproject.org/builders/tor-browser-bundle.git/tree/Bundle-Data/Docs/ChangeLog.txt?h=maint-5.5>
- - <https://geti2p.net/en/>
- - <https://github.com/i2p/i2p.i2p/blob/master/debian/changelog>
- - <https://www.mozilla.org/en-US/thunderbird/notes/>
- - <https://github.com/spesmilo/electrum/blob/master/RELEASE-NOTES>
- - <https://gitweb.torproject.org/torbirdy.git/tree/ChangeLog>
+ - Tor: <https://blog.torproject.org/>
+ - Tor: <https://gitweb.torproject.org/tor.git/tree/ChangeLog>
+ - Tor Browser: <https://gitweb.torproject.org/builders/tor-browser-bundle.git/tree/Bundle-Data/Docs/ChangeLog.txt?h=maint-6.5>
+ - I2P: <https://geti2p.net/en/>
+ - I2P: <https://github.com/i2p/i2p.i2p/blob/master/debian/changelog>
+ - Icedove: <https://www.mozilla.org/en-US/thunderbird/notes/>
+ - Electrum: <https://github.com/spesmilo/electrum/blob/master/RELEASE-NOTES>
+ - TorBirdy: <https://gitweb.torproject.org/torbirdy.git/tree/ChangeLog>
+ - obfs4proxy: <https://anonscm.debian.org/cgit/pkg-privacy/packages/obfs4proxy.git/tree/ChangeLog>
- Add screenshots of cool stuff
- Resize them to 66% if needed
+ - Document manual steps that persistence users may need to go
+ through, taking into account that we support automatic updates
+ from the two last releases (not mentioning manual updates).
+ It may imply to refer to, or copy from, such instructions that
+ were documented in the _previous_ release notes.
- Write the draft
- Use full sentences for major changes ("*We installed*", "*You can*")
- Use present tense without subject for minor changes ("*Upgrade*", "*Fix*")