diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
index 919419d..1f97ef5 100644
--- a/CONTRIBUTING.md
+++ b/CONTRIBUTING.md
@@ -42,7 +42,7 @@ workflows are as follows:
 - `integration_test.yaml`: This runs the suite of integration tests included
   with the charm and runs on every pull request.
 - `publish_charm.yaml`: This runs either by manual dispatch or on every
-  push to the main branch or a special track/\*\* branch. Once a PR is merged
+  push to the main branch. Once a PR is merged
   with one of these branches, this workflow runs to ensure the tests have passed
   before building the charm and publishing the new version to the edge channel
   on Charmhub.
diff --git a/README.md b/README.md
index 56a9b41..a1c2bca 100644
--- a/README.md
+++ b/README.md
@@ -64,7 +64,7 @@ The Temporal operators can be deployed and connected to each other using the
 Juju command line as follows:
 
 ```bash
-juju deploy temporal-k8s --config num-history-shards=512
+juju deploy temporal-k8s --config num-history-shards=4 # This value can be increased to 1024 or 2048 for a production deployment
 juju deploy temporal-admin-k8s
 juju relate temporal-k8s:db postgresql-k8s:database
 juju relate temporal-k8s:visibility postgresql-k8s:database