blob: 53f884c4728b17c78d59459e546185ade3db1fbe (
plain) (
blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
|
How to cut a Newsboat release
-----------------------------
This document describes all the steps one should go through in order to make
a new release. The person doing the release should have push access to the
master repository and shell access to newsboat.org.
1. Update CHANGELOG
* Consult `git log --reverse PREVIOUS_VERISION..`
* Mention issue number ("#X" for Newsboat issues, full link to issue tracker
for Newsbeuter issues)
* Mention the name of contributor
* Acknowledge contributions from people whose changes didn't make it into
the lists
2. Update version in config.h
3. Update links to docs and FAQ in README
4. Create new tag:
* `git tag --sign -u 'newsboat@googlegroups.com' rVERSION`
* First line: "Release Newsboat VERSION"
* Description: copy of changelog entry
* Don't use "###" style for headers because they'll be stripped ("#" is
a shell comment). Use "===" style instead
5. Prepare the tarball
* Clone your local clone somewhere else
* In that new clone, `rm -rf .git`
* Rename that clone to newsboat-VERSION
* Pack that clone in a tarball:
`tar cvJf newsboat-VERSION.tar.xz newsboat-VERSION`
* Sign the tarball:
`gpg2 --sign-with 'newsboat@googlegroups.com' --detach-sign --armour newsboat-VERSION.tar.xz`
* Upload both files to newsboat.org staging area
6. Prepare the docs
* In your local clone: `make -j5 doc`
* Upload contents of `doc/xhtml/` to newsboat.org staging area
7. Publish the release
* Prepare the directory on the server
* `cp -rfv /usr/local/www/newsboat.org/www/ newsboat`
* Prepare directories: `mkdir -p newsboat/releases/VERSION/docs`
* Move tarball and its signature:
`mv newsboat-VERSION* newsboat/releases/VERSION/`
* Prepare docs:
`gzip --keep --best docbook-xsl.css faq.html newsboat.html`
* Move docs:
`mv docbook-xsl.css* faq.html* newsboat.html* newsboat/releases/VERSION/docs/`
* Edit `newsboat/index.html`
* Move current release to the list of previous releases
* Update current release version
* Update current release date
* Update current release links
* Update the year in the page copyright if necessary
* Gzip the result: `gzip --best --keep --force newsboat/index.html`
* Edit `newsboat/news.atom`
* Update `<updated>` field of the channel
* Use the same date-time for `<published>` and `<updated>` in new
`<entry>`
* Update entry's `<link>` and `<id>` to point to new docs'
`newsboat.html`
* `<title>`: "Newsboat VERSION is out"
* Gzip the result: `gzip --best --keep --force newsboat/news.atom`
* Prepare an email to the mailing list
* Same topic and contents as in `news.atom` entry
* Clear-sign instead of detach-sign: select the body and run it through
`gpg2 --clearsign`
* Deploy the directory on the server:
`sudo cp -rv newsboat/ /usr/local/www/newsboat.org/www/ && sudo chmod -R a+r /usr/local/www/newsboat.org/www/`
* Push the code: `git push && git push --tags`
8. Tell the world about it
* Send an email to the mailing list
* Change the topic on #newsboat at Freenode
* Post something about it on personal Mastodon
9. Prepare the repo for the next release
* Add "Unreleased" section to CHANGELOG
* Push it: `git push`
10. Release the snap
* Go to https://dashboard.snapcraft.io/ and log in
* Go to https://dashboard.snapcraft.io/snaps/newsboat/revisions/ and for
each revision that corresponds to the release:
* Click on the revision number
* In "Channels" row, click "Release"
* Tick all checkboxes ("stable", "candidate", "beta", and "edge")
* Click "Release"
11. Manage milestones https://github.com/newsboat/newsboat/milestones?with_issues=no
* Add all unassigned issues and pull requests to the current one. Search for
"no:milestone closed:>=2018-09-20" where "2018-09-20" is the previous
release date
* Close the current one
* Create a new one with a date set to 25-ish of March/June/September/December
|
