diff --git a/notes.md b/notes.md index da39bcc..4ec5b87 100644 --- a/notes.md +++ b/notes.md @@ -49,14 +49,48 @@ Limitations (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 $!; 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 ---------