diff --git a/app/cli/cmd/policy_develop.go b/app/cli/cmd/policy_develop.go
index 5d188d3de..0e056cc3d 100644
--- a/app/cli/cmd/policy_develop.go
+++ b/app/cli/cmd/policy_develop.go
@@ -23,9 +23,9 @@ func newPolicyDevelopCmd() *cobra.Command {
 	cmd := &cobra.Command{
 		Use:     "develop",
 		Aliases: []string{"devel"},
-		Short: `Tools for policy development
-Refer to https://docs.chainloop.dev/guides/custom-policies
-`,
+		Short:   `Tools for policy development`,
+		Long: `A set of tools to facilitate policy development.
+Refer to https://docs.chainloop.dev/guides/custom-policies for more information.`,
 	}
 
 	cmd.AddCommand(newPolicyDevelopInitCmd(), newPolicyDevelopLintCmd(), newPolicyDevelopEvalCmd())
diff --git a/app/cli/documentation/cli-reference.mdx b/app/cli/documentation/cli-reference.mdx
index 3926bdf32..d21f30f2e 100755
--- a/app/cli/documentation/cli-reference.mdx
+++ b/app/cli/documentation/cli-reference.mdx
@@ -2807,7 +2807,11 @@ Options inherited from parent commands
 ### chainloop policy develop
 
 Tools for policy development
-Refer to https://docs.chainloop.dev/guides/custom-policies
+
+Synopsis
+
+A set of tools to facilitate policy development.
+Refer to https://docs.chainloop.dev/guides/custom-policies for more information.
 
 Options