diff --git a/README.md b/README.md
index f25f73a23..b553f24b2 100644
--- a/README.md
+++ b/README.md
@@ -14,6 +14,8 @@ from your source code repository.
 
 ---
 
+Why are you adding this line?
+
 ## 🚀 Introduction
 
 Pipelines-as-Code follows the [Pipelines-as-Code
diff --git a/pkg/pipelineascode/pipelineascode.go b/pkg/pipelineascode/pipelineascode.go
index c0384b9f7..968ed6849 100644
--- a/pkg/pipelineascode/pipelineascode.go
+++ b/pkg/pipelineascode/pipelineascode.go
@@ -310,6 +310,11 @@ func getMergePatch(annotations, labels map[string]string) map[string]any {
 	}
 }
 
+// getExecutionOrderPatch returns a patch to set the execution order of the pipelineRun
+// the order is a comma separated list of pipelineRun names
+// the order is used to determine the order in which the pipelineRuns are executed
+// the order is set in the metadata.annotations.execution-order annotation
+// the order is used to determine the order in which the pipelineRuns are executed.
 func getExecutionOrderPatch(order string) map[string]any {
 	return map[string]any{
 		"metadata": map[string]any{