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..9c76924 100644
--- a/README.md
+++ b/README.md
@@ -1,7 +1,7 @@
 [![Charmhub Badge](https://charmhub.io/airbyte-k8s/badge.svg)](https://charmhub.io/airbyte-k8s)
 [![Release Edge](https://github.com/canonical/airbyte-k8s-operator/actions/workflows/publish_charm.yaml/badge.svg)](https://github.com/canonical/airbyte-k8s-operator/actions/workflows/publish_charm.yaml)
 
-# Airbyte K8s Operator
+# Airbyte Server
 
 This is the Kubernetes Python Operator for [Airbyte](https://airbyte.com/).
 
@@ -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
@@ -107,4 +107,5 @@ required integrations exist.
 This charm is still in active development. Please see the
 [Juju SDK docs](https://juju.is/docs/sdk) for guidelines on enhancements to this
 charm following best practice guidelines, and
-[CONTRIBUTING.md](./CONTRIBUTING.md) for developer guidance.
+[CONTRIBUTING.md](https://github.com/canonical/airbyte-k8s-operator/blob/main/CONTRIBUTING.md)
+for developer guidance.