doc: Update post-release instructions

This reflects the post-release changes that have been taken care of
and are still considered somewhat meaningful.

MD5 checksums have been replaced by SHA512 and SHA256 checksum files
on the Releases page.  The descriptions.db was used by the no longer
existant Search Engine on the website.
merge-requests/91/head
Olaf Meeuwissen 2019-08-01 21:13:19 +09:00
rodzic 5aa523289f
commit 9a16b62e33
1 zmienionych plików z 17 dodań i 16 usunięć

Wyświetl plik

@ -32,34 +32,35 @@ Before the release:
Making the release:
* temporarily set a PRIVATE_TOKEN variable in the GitLab CI/CD
variables You have to create one in your own Settings > Access
Tokens. Set it to expire in a few hours to avoid abuse.
variables. You have to create one in your own Settings > Access
Tokens. Set it to expire the next day to avoid abuse. Better yet,
remove it from the CI/CD variables when the job is finished.
* git tag -a -s 1.0.28 -m Release
* git push --tags origin master
* trigger the manual 'release' stage of the build via the web UI when
this becomes possible. This requires a valid PRIVATE_TOKEN.
Announcing the release:
Updating the website and announcing the release:
* [TBD] checkout the sane/website.git module and:
* [TBD] copy sane-backends.html to sane-backends-"old-version".html
* [TBD] update sane-supported-devices.html with link to above "old" file
* [TBD] rebuild sane-backends.html and sane-mfgs.html (make -C doc html-pages)
* checkout the sane/website.git module and:
* copy sane-backends.html to sane-backends-"old-version".html
* update sane-supported-devices.html with link to above "old" file
* rebuild sane-backends.html and sane-mfgs.html (make -C doc html-pages)
* [TBD] use man2html from http://hydra.nac.uci.edu/indiv/ehood/man2html.html
to rebuild html man pages (make -C doc html-man) (no other version works)
* [TBD] add md5 sum to sane-md5sums.txt
* [TBD] check and update platforms page (sane-support.html)
* add announcement to index.html
* update announcement to index.html
* git commit -a && git push
* check that website was updated automatically
* [TBD] rebuild descriptions.db (make -C doc descriptions.db)
* announce release on sane-devel and sane-announce mailing lists
* check that website's pipeline succeeded
* announce release on sane-announce mailing list (and Cc: sane-devel).
Ping the sane-announce list's moderator (m. allan noah) to get your
post approved ASAP.
After the release:
* [TBD] copy ChangeLog to ChangeLogs/ChangeLog-$version
* [TBD] start a new ChangeLog via git checkout ChangeLog
* [TBD] bump version number in tools/create-changelog.sh
* extract source tarball's ChangeLog to ChangeLogs/ChangeLog-$version
(and strip the file's trailer pointing to ChangeLogs/)
* start a new ChangeLog via git checkout ChangeLog
* bump version number in tools/create-changelog.sh
* remove the ':new' tag from all doc/descriptions*/*.desc files
* git add new and changed files and commit
* git push