Home

Resume YouTube Subs extension wiki

For general details on the extension see README.md.

Release instructions

Step by step instructions how to release the Resume YouTube Subs Chrome extension.

1. The release instructions assume that the git tool is already installed and that you already have a local clone of the resume-youtube-subs Chrome extension source code.

2. Install the jq tool. This only needs to be done once.
   Under Ubuntu/Debian/Mint Linux you can install it by running:

   sudo apt install jq

3. Change the working directory of your shell to the main directory of the extension code (the directory with manifest.json).

   Note: All commands are intended for the Bash shell under Linux.

4. Double check that there are no newer upstream commits.

   git pull origin

5. Double check files for remaining TODOs that should be resolved as part of this release.

   grep -rInH --exclude-dir=.git TODO .

6. Test the extension multiple times (at least 10 times each) for each supported configuration.
   The supported configurations are:

   Note: Don't forget to reload the locally unpacked extension and to remove older versions before doing the tests.

   1. Chrome stable + The YouTube subscriptions page in grid view.
   2. Chrome stable + The YouTube subscriptions page in list view.

7. Make sure the documentation is up to date. Double check the following files:

   1. README.md
   2. Wiki

8. Increase the extension version in manifest.json. The version number adheres to the semantic versioning rules.

9. Review and commit the changes after double checking that all new files (if there are any) are actually included in the commit(s).

   git status

   git diff --cached

   git commit

10. Tag HEAD commit with the new version from manifest.json.

    version=$(jq -r '.version' manifest.json) && git tag -a -m "${version} release" "v${version}" HEAD

11. Push commit(s) and new version tag upstream.

    git push origin && git push origin --tags

12. Create a zip archive of the extension for the upload to the Chrome Web Store.

    Note: The zip archive will be created in the parent directory.

    version=$(jq -r '.version' manifest.json) && git archive -o "../resume-youtube-subs-${version}.zip" -9 "v${version}"

13. Publish update

    1. Go to the Chrome Web Store Developer Dashboard.
    2. Click on Items (left side panel).
    3. Click on the existing Resume YouTube Subs extension item.
    4. Click on Package (left side bar).
    5. Click on Upload new package and upload the new zip archive.
    6. Review Store listing (left side bar) and use use the Preview (overflow menu next to Submit for review).
    7. Save draft and Submit for review.

14. Once the update of the extension is approved double check that the update actually is published.