diff --git a/docs/upgrading.md b/docs/upgrading.md
index 59a599d398c7..e43b6053a9ea 100644
--- a/docs/upgrading.md
+++ b/docs/upgrading.md
@@ -7,7 +7,7 @@ the [conventional commits](https://www.conventionalcommits.org/en/v1.0.0/#summar
 
 ### [3fff791e4](https://github.com/argoproj/argo-workflows/commit/3fff791e4ef5b7e1de82ccb36cae327e8eb726f6) build!: Automatically add manifests to `v*` tags (#5880)
 
-The manifests in the repository on the tag will longer contain the image tag, instead they contain `:latest`.
+The manifests in the repository on the tag will no longer contain the image tag, instead they will contain `:latest`.
 
 * You must not get your manifests from the Git repository, you must get them from the release notes.
 * You must not use the `stable` tag. This is defunct, and will be removed in v3.1.
@@ -16,7 +16,7 @@ The manifests in the repository on the tag will longer contain the image tag, in
 
 ### [defbd600e](https://github.com/argoproj/argo-workflows/commit/defbd600e37258c8cdf30f64d4da9f4563eb7901) fix: Default ARGO_SECURE=true. Fixes #5607 (#5626)
 
-The server now starts with TLS enabled by default if a key is available. This can be disabled using `--secure=false`.
+The server now starts with TLS enabled by default if a key is available. The original behaviour can be configured with `--secure=false`.
 
 If you have an ingress, you may need to add the appropriate annotations:(varies by ingress):
 
@@ -27,7 +27,7 @@ nginx.ingress.kubernetes.io/backend-protocol: HTTPS
 
 ### [01d310235](https://github.com/argoproj/argo-workflows/commit/01d310235a9349e6d552c758964cc2250a9e9616) chore(server)!: Required authentication by default. Resolves #5206 (#5211)
 
-To login to the user interface, you must provide a login token. This can be disabled with `--auth-mode=server`.
+To login to the user interface, you must provide a login token. The original behaviour can be configured with `--auth-mode=server`.
 
 ### [f31e0c6f9](https://github.com/argoproj/argo-workflows/commit/f31e0c6f92ec5e383d2f32f57a822a518cbbef86) chore!: Remove deprecated fields (#5035)
 
@@ -47,4 +47,4 @@ kubectl get wf --all-namespaces -o yaml | grep ttlSecondsAfterFinished
 
 ### [c8215f972](https://github.com/argoproj/argo-workflows/commit/c8215f972502435e6bc5b232823ecb6df919f952) feat(controller)!: Key-only artifacts. Fixes #3184 (#4618)
 
-This change is not breaking per-se, but many users do not appear to aware of [artifact repository ref](artifact-repository-ref.md).
\ No newline at end of file
+This change is not breaking per-se, but many users do not appear to aware of [artifact repository ref](artifact-repository-ref.md), so check your usage of that feature if you have problems.