diff --git a/pkg/promote/pr.go b/pkg/promote/pr.go
index ad2f31b..9dc0a9f 100644
--- a/pkg/promote/pr.go
+++ b/pkg/promote/pr.go
@@ -47,7 +47,7 @@ func (o *Options) PromoteViaPullRequest(envs []*jxcore.EnvironmentConfig, releas
 		defer func() { o.PullRequestFilter = nil }()
 	}
 
-	comment := "this commit will trigger a pipeline to [generate the actual kubernetes resources to perform the promotion](https://jenkins-x.io/docs/v3/about/how-it-works/#promotion) which will create a second commit on this Pull Request before it can merge"
+	comment := "this commit will trigger a pipeline to [generate the actual kubernetes resources to perform the promotion](https://jenkins-x.io/v3/about/how-it-works/#promotion) which will create a second commit on this Pull Request before it can merge"
 
 	if draftPR {
 		labels = append(labels, "do-not-merge/hold")
diff --git a/pkg/promote/promote.go b/pkg/promote/promote.go
index 2b34e4e..67b7f09 100644
--- a/pkg/promote/promote.go
+++ b/pkg/promote/promote.go
@@ -129,7 +129,7 @@ var (
 	promoteLong = templates.LongDesc(`
 		Promotes a version of an application to zero to many permanent environments.
 
-		For more documentation see: [https://jenkins-x.io/docs/getting-started/promotion/](https://jenkins-x.io/docs/getting-started/promotion/)
+		For more documentation see: [https://jenkins-x.io/v3/develop/environments/](https://jenkins-x.io/v3/develop/environments/)
 
 `)