chore: add comment for Run func

zakisk · zakisk · commit 3e808668ea78 · 2025-08-19T11:40:32.000+05:30
Signed-off-by: Zaki Shaikh &lt;zashaikh@redhat.com&gt;
diff --git a/pkg/pipelineascode/pipelineascode.go b/pkg/pipelineascode/pipelineascode.go
@@ -54,6 +54,12 @@ func NewPacs(event *info.Event, vcx provider.Interface, run *params.Run, pacInfo
 	}
 }
 
+// Run is the main orchestration entrypoint for processing a single incoming event.
+// It matches the event to repository rules, creates or updates Tekton PipelineRuns,
+// manages concurrency (including pending/queued state), emits provider statuses,
+// and finally patches PipelineRuns with execution order information when applicable.
+// The call blocks until all asynchronous operations launched for this event complete.
+// Context is used to propagate deadlines/cancellation to downstream clients.
 func (p *PacRun) Run(ctx context.Context) error {
 	matchedPRs, repo, err := p.matchRepoPR(ctx)
 	if repo != nil && p.event.TriggerTarget == triggertype.PullRequestClosed {

Original file line number	Diff line number	Diff line change
`@@ -54,6 +54,12 @@ func NewPacs(event info.Event, vcx provider.Interface, run params.Run, pacInfo`
`54`	`54`	`}`
`55`	`55`	`}`
`56`	`56`
	`57`	`+// Run is the main orchestration entrypoint for processing a single incoming event.`
	`58`	`+// It matches the event to repository rules, creates or updates Tekton PipelineRuns,`
	`59`	`+// manages concurrency (including pending/queued state), emits provider statuses,`
	`60`	`+// and finally patches PipelineRuns with execution order information when applicable.`
	`61`	`+// The call blocks until all asynchronous operations launched for this event complete.`
	`62`	`+// Context is used to propagate deadlines/cancellation to downstream clients.`
`57`	`63`	`func (p *PacRun) Run(ctx context.Context) error {`
`58`	`64`	`matchedPRs, repo, err := p.matchRepoPR(ctx)`
`59`	`65`	`if repo != nil && p.event.TriggerTarget == triggertype.PullRequestClosed {`