diff --git a/.github/workflows/release.yml b/.github/workflows/release.yml
index 2662b77..e012a16 100644
--- a/.github/workflows/release.yml
+++ b/.github/workflows/release.yml
@@ -1,4 +1,18 @@
-# https://github.com/changesets/action
+#also has a specific scope https://github.com/changesets/action
+
+########################################################################################
+# The following secrets are required:
+#
+# 1. NPM_TOKEN - A "fine-grained personal access token" generated through the
+#    npmjs.com UI. Tokens are generated at the user level, rather than organisation
+#    level. Each token is also scoped to the specific package.
+#
+#    The following minimum permissions are required:
+#      Read & write - access to package & scope
+#
+# 2. GITHUB_TOKEN - automatically provided by Github to workflow runs. 
+########################################################################################
+
 name: Release
 
 on: