From 935c1217ec3bb60024dd81bbccbe78b22e45315f Mon Sep 17 00:00:00 2001
From: Xi Zhang <xizhang@oasislabs.com>
Date: Fri, 13 Oct 2023 11:25:44 -0500
Subject: [PATCH] Update documentation

---
 .github/workflows/publish.yaml |  6 +++---
 CONTRIBUTING.md                |  4 ++--
 README.md                      | 11 ++++++++++-
 3 files changed, 15 insertions(+), 6 deletions(-)

diff --git a/.github/workflows/publish.yaml b/.github/workflows/publish.yaml
index 91ae3067..34d9f5bc 100644
--- a/.github/workflows/publish.yaml
+++ b/.github/workflows/publish.yaml
@@ -3,9 +3,9 @@ name: publish
 on:
   push:
     tags:
-      - clients/js/[0-9].[0-9]+.[0-9]+
-      - contracts/[0-9].[0-9]+.[0-9]+
-      - integrations/hardhat/[0-9].[0-9]+.[0-9]+
+      - clients/js/v[0-9].[0-9]+.[0-9]+
+      - contracts/v[0-9].[0-9]+.[0-9]+
+      - integrations/hardhat/v[0-9].[0-9]+.[0-9]+
 
 jobs:
   publish:
diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
index fa79ada2..b9af0051 100644
--- a/CONTRIBUTING.md
+++ b/CONTRIBUTING.md
@@ -65,9 +65,9 @@ if the issue is not reported yet, [file a new one].
 
 ## Development
 
-### Building and Testing
+### Building
 
-Building and testing are documented in our
+Building documentation lies at the top-level
 [README](https://github.com/oasisprotocol/sapphire-paratime/blob/main/README.md).
 
 ### Contributing Code
diff --git a/README.md b/README.md
index e2353afe..8d00f97c 100644
--- a/README.md
+++ b/README.md
@@ -34,6 +34,15 @@ development environments
 - [`runtime`](./runtime/): the Sapphire Paratime as based off of the
 [Oasis SDK](https://github.com/oasisprotocol/oasis-sdk)
 
+## Release
+
+### Clients
+
+JS libraries should be updated with a version bump in the `package.json`
+file and a respective tag in the pattern of `{{path}}/v{{semver}}`, such as
+`clients/js/v1.1.1`.
+
+
 ## Contributing
 
 Developers are encouraged to contribute their improvements to the Sapphire
@@ -47,4 +56,4 @@ See our [Contributing Guidelines](CONTRIBUTING.md).
 Oasis remains committed to unlocking the full potential of privacy applications
 on Web3.
 
-Join the [Privacy4Web3 Hackathon](https://oasisprotocol.org/p4w3-hackathon) today!
+Build with [us](https://oasisprotocol.org/opl#how-to-get-started) today!