docs: clarify GitHub webhook behavior for multiple tag pushes

Add warning in event matching documentation to clarify GitHub's
limitation when pushing multiple tags simultaneously. Specifically
documents that GitHub does not send webhook events when more than
three tags are pushed at once (e.g., using 'git push origin --tags').

This helps users understand why pipeline runs may not trigger when
pushing bulk tags and provides a link to GitHub's official
documentation for reference.

Fixes #2252

Signed-off-by: Zaki Shaikh <[email protected]>

Author: zakisk

docs/content/docs/guide/matchingevents.md

@@ -58,6 +58,10 @@ annotations:
 This will match the pipeline `pipeline-push-on-1.0-tags` when you push the 1.0
 tags into your repository.
 
+{{< hint warning >}}
+GitHub does not send webhook events when more than three tags are pushed simultaneously (e.g., with `git push origin --tags`). To ensure pipeline runs are triggered for all tags, push them in batches of three or fewer. [See GitHub's docs here](https://docs.github.com/en/actions/reference/workflows-and-actions/events-that-trigger-workflows#create).
+{{< /hint >}}
+
 Matching annotations are currently required; otherwise, Pipelines-as-Code will not
 match your `PipelineRun`.