Added release checklist (closes #3)

gh-pages
Hauke D 7 years ago
parent d4e89eceab
commit d0c97c45d7

@ -49,14 +49,48 @@ Limitations
(Emscripten apparently only supports asm.js dynamic linking when dynamic memory growth is disabled, which is not very useful) (Emscripten apparently only supports asm.js dynamic linking when dynamic memory growth is disabled, which is not very useful)
Miscellaneous Release Checklist
------------- -----------------
- Generating a [Subresource Integrity](https://developer.mozilla.org/en-US/docs/Web/Security/Subresource_Integrity) value: - Update `Changes.md` with all changes since last release
As an example, to list changes between `v0.03-beta` and `v0.05-beta`, excluding the regex tester:
$ git log --stat v0.03-beta..v0.05-beta -- . ':!web/regex_demo.html' ':!web/regex_tester.html' ':!.gitignore'
- Also make sure that the documentation in `using.md` etc. mentions when features were added/deprecated
- Update version numbers everywhere; use `grep` to find them, for example:
$ grep -Er --exclude-dir=.git --exclude-dir=emperl5 --exclude=emperl.* '0\.0[0-9]' * emperl5/ext/WebPerl
At a minimum there is:
- `web/webperl.js` - `Perl.WebPerlVersion`
- `emperl5/ext/WebPerl/WebPerl.pm` - `$VERSION`
- `pages/index.md` - download links
- Update [Subresource Integrity](https://developer.mozilla.org/en-US/docs/Web/Security/Subresource_Integrity) values as needed, e.g.:
$ perl -wMstrict -MDigest -le 'open my $fh, "<:raw", "web/webperl.js" or die $!; $ perl -wMstrict -MDigest -le 'open my $fh, "<:raw", "web/webperl.js" or die $!;
print Digest->new("SHA-256")->addfile($fh)->b64digest' print Digest->new("SHA-256")->addfile($fh)->b64digest'
- Build and create dist, e.g. `build/build.pl --reconfig --dist=webperl_prebuilt_v0.05-beta`
- Test all build results, both from file:// and http://localhost
- Add tags, the `webperl` repo gets an annotated tag such as `v0.05-beta`,
and the `emperl5` repo gets an unannotated tag such as `webperl_v0.05-beta`,
then `git push --tags`
- Create a release on GitHub and upload the `webperl_prebuilt_*.zip` as an asset
- If there was a `pages_for_vX.XX` branch of `gh-pages`, don't forget to merge that
- Uploading to AWS S3:
1. Run `gzip -9` on `emperl.*` and `webperl.js`
2. Rename them to remove the `.gz` ending
3. Upload them with the appropriate `Content-Type` (see e.g. `web/webperl.psgi`) and a `Content-Encoding` of `gzip`
Prior Art Prior Art
--------- ---------

Loading…
Cancel
Save