Update docs/RELEASE.md to reflect new update_latest.yml workflow.
@@ -50,9 +50,10 @@ to a minimum.
prior minor release and provides a starting point for maintenance releases
to the new minor release.
-* We have a `staging` branch for the website content. The
- documentation team updates the website content on that branch, then
- creates PRs to merge their changes into the default branch.
+* For website content, the staging website always reflects what is on the
+ master branch. The documentation team provides PRs that target the master
+ branch. When they are merged, the website workflow runs, causing the
+ staging website content to be updated.
## Workflows
@@ -74,9 +75,15 @@ additional steps are taken depending on the trigger.
these tests use up to Docker Hub on pushes to the default branch.
The [`website`](../.github/workflows/website.yml) workflow handles building and
-deploying the [`website/`](../website/) content to <https://appscope.dev/> from
-the default branch and <https://staging.appscope.dev/> from `staging`. See the
-build script in that folder for details.
+deploying the [`website/`](../website/) content to <https://staging.appscope.dev/>
+and <https://appscope.dev/>. The staging website is intended to always reflect
+the master branch. The production website is updated only when a "web" tag
+has been applied and pushed. See the build script in that folder for details.
+
+The [`update_latest`](../.github/workflows/update_latest.yml) workflow updates
+the value returned by `https://cdn.cribl.io/dl/scope/latest`, and updates
+the `latest` tag at `https://hub.docker.com/r/cribl/scope/tags`. This workflow
+is run manually, and does not have any automatic triggers.
## CDN
@@ -84,15 +91,11 @@ We push the built and tested `scope` binary and a TGZ package to an AWS S3
container exposed at `https://cdn.cribl.io/dl/scope/`. Below
that base URL we have:
-* `latest` - text file with the latest release number in it; e.g., `0.6.1`
* `$VERSION/linux/scope`
* `$VERSION/linux/scope.md5`
* `$VERSION/linux/scope.tgz`
* `$VERSION/linux/scope.tgz.md5`
-The `latest` file is updated only for builds of `v*` tags without `-rc` in
-them.
-
Starting with the `v0.7.2` release, we are building separate x86 and ARM
versions of AppScope. The links described above still lead to the x86 files.
We've added arch-specific links for the `x86_64` and `aarch64` files.
@@ -133,8 +136,7 @@ repositories at Docker Hub. See [`docker/`](../docker/) for details on how
those images are built.
We currently build these for release `v*` tags and tag the images to match with
-the leading `v` stripped off. If the git tag isn't a preprelease tag and is the
-last one then we apply the `:latest` tag to the image too.
+the leading `v` stripped off.
```text
docker run --rm -it cribl/scope:latest
