From 8c96289458f3a6aba36e764046258c6186d946fc Mon Sep 17 00:00:00 2001
From: Ackberry <akbari@usf.edu>
Date: Sun, 14 Jun 2026 14:50:21 -0400
Subject: [PATCH] docs: document StepAction support in Hub Resolver

The Hub Resolver supports `stepaction` as a `kind` value
(see `supportedKinds` in pkg/resolution/resolver/hub/resolver.go),
but the docs only listed `task` and `pipeline`.

Update docs/hub-resolver.md to:
- list `stepaction` as a supported `kind` value
- note that Artifact Hub StepAction packages use the
  `tekton-stepaction` package type
- add a StepAction resolution example, matching the existing
  Task and Pipeline examples

Also note that, unlike `task`/`pipeline`, `stepaction` has no
default catalog in resolveCatalogName, so `catalog` must be set
explicitly.

Fixes #10202
---
 docs/hub-resolver.md | 31 +++++++++++++++++++++++++++++--
 1 file changed, 29 insertions(+), 2 deletions(-)

diff --git a/docs/hub-resolver.md b/docs/hub-resolver.md
index 0731e915102..aca05ef40ae 100644
--- a/docs/hub-resolver.md
+++ b/docs/hub-resolver.md
@@ -13,9 +13,9 @@ Use resolver type `hub`.
 
 | Param Name       | Description                                                                   | Example Value                                              |
 |------------------|-------------------------------------------------------------------------------|------------------------------------------------------------|
-| `catalog`        | The catalog from where to pull the resource (Optional)                        | Default:  `tekton-catalog-tasks` (for `task` kind);  `tekton-catalog-pipelines` (for `pipeline` kind)                                        |
+| `catalog`        | The catalog from where to pull the resource (Optional)                        | Default:  `tekton-catalog-tasks` (for `task` kind);  `tekton-catalog-pipelines` (for `pipeline` kind); no default for `stepaction` kind, so `catalog` must be set explicitly |
 | `type`           | The type of Hub from where to pull the resource (Optional). Either `artifact` or `tekton` | Default:  `artifact` (recommended). Note: `tekton` type is deprecated.                                         |
-| `kind`           | Either `task` or `pipeline` (Optional)                                        | Default: `task`                                                     |
+| `kind`           | `task`, `pipeline` or `stepaction` (Optional)                                        | Default: `task`                                                     |
 | `name`           | The name of the task or pipeline to fetch from the hub                        | `golang-build`                                             |
 | `version`        | Version or a Constraint (see [below](#version-constraint) of a task or a pipeline to pull in from. Wrap the number in quotes!   | `"0.5.0"`, `">= 0.5.0"`                                                    |
 | `url`            | Custom hub API endpoint to query instead of the cluster-configured default (Optional). Must be an absolute HTTP or HTTPS URL. Overrides all other URL configuration (ConfigMap URL lists, environment variables, and defaults). | `https://internal-hub.example.com`                        |
@@ -131,6 +131,33 @@ spec:
   # overall will not succeed without those parameters.
 ```
 
+### StepAction Resolution
+
+```yaml
+apiVersion: tekton.dev/v1
+kind: TaskRun
+metadata:
+  name: hub-stepaction-demo
+spec:
+  taskSpec:
+    steps:
+    - name: git-clone
+      ref:
+        resolver: hub
+        params:
+        - name: catalog
+          value: git-clone-stepaction
+        - name: type # optional
+          value: artifact
+        - name: kind
+          value: stepaction
+        - name: name
+          value: git-clone
+        - name: version
+          value: "1.6.0"
+  # Note: Artifact Hub StepAction packages use the tekton-stepaction package type
+```
+
 ### Task Resolution from a Private Hub
 
 ```yaml