diff --git a/CHANGELOG.md b/CHANGELOG.md
index 955dd0c89..40b0777d1 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -32,7 +32,7 @@ Fixes:
 
 This prerelease graduates the notification APIs to `v1beta2`.
 In addition, this version comes with support for
-[Gitea commit status updates](https://github.com/fluxcd/notification-controller/blob/api/v0.30.0/docs/spec/v1beta2/provider.md#gitea).
+[Gitea commit status updates](https://github.com/fluxcd/notification-controller/blob/api/v0.30.0/docs/spec/v1beta2/providers.md#gitea).
 
 ### `notification.toolkit.fluxcd.io/v1beta2`
 
diff --git a/docs/spec/v1beta2/providers.md b/docs/spec/v1beta2/providers.md
index 9623be59c..e160db677 100644
--- a/docs/spec/v1beta2/providers.md
+++ b/docs/spec/v1beta2/providers.md
@@ -1318,7 +1318,7 @@ the BitBucket repository specified in `.spec.address`.
 You can create the secret with `kubectl` like this:
 
 ```shell
-kubectl create secret generic gitlab-token --from-literal=token=<username>:<app-password>
+kubectl create secret generic bitbucket-token --from-literal=token=<username>:<app-password>
 ```
 
 #### Azure DevOps
@@ -1331,7 +1331,7 @@ The token must have permissions to update the commit status for the Azure DevOps
 You can create the secret with `kubectl` like this:
 
 ```shell
-kubectl create secret generic github-token --from-literal=token=<AZURE-TOKEN>
+kubectl create secret generic azuredevops-token --from-literal=token=<AZURE-TOKEN>
 ```
 
 ## Provider Status