From 1161a56be7b5a8a0eea5c37fb959b69504e637f1 Mon Sep 17 00:00:00 2001
From: Andrew Bayer <andrew.bayer@gmail.com>
Date: Fri, 25 Mar 2022 08:36:05 -0400
Subject: [PATCH] Update external API reference links for kubernetes-api types
 to v1.22

Signed-off-by: Andrew Bayer <andrew.bayer@gmail.com>
---
 docs/pipeline-api.md                | 585 +++++++++++++++++++++++++---
 go.mod                              |   2 +-
 go.sum                              |   1 -
 hack/reference-docs-gen-config.json |   2 +-
 hack/update-reference-docs.sh       |   1 +
 5 files changed, 543 insertions(+), 48 deletions(-)

diff --git a/docs/pipeline-api.md b/docs/pipeline-api.md
index e160a627d99..83b23c6f55f 100644
--- a/docs/pipeline-api.md
+++ b/docs/pipeline-api.md
@@ -1,3 +1,11 @@
+<!--
+---
+title: Pipeline API
+linkTitle: Pipeline API
+weight: 1000
+---
+-->
+
 <p>Packages:</p>
 <ul>
 <li>
@@ -65,7 +73,7 @@ string
 <td>
 <code>metadata</code><br/>
 <em>
-<a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.21/#objectmeta-v1-meta">
+<a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.22/#objectmeta-v1-meta">
 Kubernetes meta/v1.ObjectMeta
 </a>
 </em>
@@ -176,7 +184,7 @@ string
 <td>
 <code>metadata</code><br/>
 <em>
-<a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.21/#objectmeta-v1-meta">
+<a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.22/#objectmeta-v1-meta">
 Kubernetes meta/v1.ObjectMeta
 </a>
 </em>
@@ -297,7 +305,7 @@ string
 <td>
 <code>metadata</code><br/>
 <em>
-<a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.21/#objectmeta-v1-meta">
+<a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.22/#objectmeta-v1-meta">
 Kubernetes meta/v1.ObjectMeta
 </a>
 </em>
@@ -465,7 +473,7 @@ string
 <td>
 <code>metadata</code><br/>
 <em>
-<a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.21/#objectmeta-v1-meta">
+<a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.22/#objectmeta-v1-meta">
 Kubernetes meta/v1.ObjectMeta
 </a>
 </em>
@@ -691,7 +699,7 @@ string
 <td>
 <code>metadata</code><br/>
 <em>
-<a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.21/#objectmeta-v1-meta">
+<a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.22/#objectmeta-v1-meta">
 Kubernetes meta/v1.ObjectMeta
 </a>
 </em>
@@ -895,7 +903,7 @@ string
 <td>
 <code>metadata</code><br/>
 <em>
-<a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.21/#objectmeta-v1-meta">
+<a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.22/#objectmeta-v1-meta">
 Kubernetes meta/v1.ObjectMeta
 </a>
 </em>
@@ -1007,7 +1015,7 @@ string
 <td>
 <code>metadata</code><br/>
 <em>
-<a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.21/#objectmeta-v1-meta">
+<a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.22/#objectmeta-v1-meta">
 Kubernetes meta/v1.ObjectMeta
 </a>
 </em>
@@ -1235,7 +1243,7 @@ string
 <td>
 <code>metadata</code><br/>
 <em>
-<a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.21/#objectmeta-v1-meta">
+<a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.22/#objectmeta-v1-meta">
 Kubernetes meta/v1.ObjectMeta
 </a>
 </em>
@@ -1347,7 +1355,7 @@ the controller, but was unused as there is no controller for PipelineResource.</
 <td>
 <code>metadata</code><br/>
 <em>
-<a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.21/#objectmeta-v1-meta">
+<a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.22/#objectmeta-v1-meta">
 Kubernetes meta/v1.ObjectMeta
 </a>
 </em>
@@ -3152,7 +3160,7 @@ via duck typing.</p>
 <td>
 <code>startTime</code><br/>
 <em>
-<a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.21/#time-v1-meta">
+<a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.22/#time-v1-meta">
 Kubernetes meta/v1.Time
 </a>
 </em>
@@ -3166,7 +3174,7 @@ Kubernetes meta/v1.Time
 <td>
 <code>completionTime</code><br/>
 <em>
-<a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.21/#time-v1-meta">
+<a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.22/#time-v1-meta">
 Kubernetes meta/v1.Time
 </a>
 </em>
@@ -3272,7 +3280,7 @@ string
 <td>
 <code>metadata</code><br/>
 <em>
-<a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.21/#objectmeta-v1-meta">
+<a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.22/#objectmeta-v1-meta">
 Kubernetes meta/v1.ObjectMeta
 </a>
 </em>
@@ -3361,7 +3369,7 @@ source mounted into /workspace.</p>
 <td>
 <code>volumes</code><br/>
 <em>
-<a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.21/#volume-v1-core">
+<a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.22/#volume-v1-core">
 []Kubernetes core/v1.Volume
 </a>
 </em>
@@ -3375,7 +3383,7 @@ steps of the build.</p>
 <td>
 <code>stepTemplate</code><br/>
 <em>
-<a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.21/#container-v1-core">
+<a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.22/#container-v1-core">
 Kubernetes core/v1.Container
 </a>
 </em>
@@ -3465,7 +3473,7 @@ string
 <td>
 <code>metadata</code><br/>
 <em>
-<a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.21/#objectmeta-v1-meta">
+<a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.22/#objectmeta-v1-meta">
 Kubernetes meta/v1.ObjectMeta
 </a>
 </em>
@@ -3632,7 +3640,7 @@ string
 <td>
 <code>metadata</code><br/>
 <em>
-<a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.21/#objectmeta-v1-meta">
+<a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.22/#objectmeta-v1-meta">
 Kubernetes meta/v1.ObjectMeta
 </a>
 </em>
@@ -3881,7 +3889,7 @@ string
 <td>
 <code>metadata</code><br/>
 <em>
-<a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.21/#objectmeta-v1-meta">
+<a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.22/#objectmeta-v1-meta">
 Kubernetes meta/v1.ObjectMeta
 </a>
 </em>
@@ -3970,7 +3978,7 @@ source mounted into /workspace.</p>
 <td>
 <code>volumes</code><br/>
 <em>
-<a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.21/#volume-v1-core">
+<a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.22/#volume-v1-core">
 []Kubernetes core/v1.Volume
 </a>
 </em>
@@ -3984,7 +3992,7 @@ steps of the build.</p>
 <td>
 <code>stepTemplate</code><br/>
 <em>
-<a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.21/#container-v1-core">
+<a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.22/#container-v1-core">
 Kubernetes core/v1.Container
 </a>
 </em>
@@ -4075,7 +4083,7 @@ string
 <td>
 <code>metadata</code><br/>
 <em>
-<a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.21/#objectmeta-v1-meta">
+<a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.22/#objectmeta-v1-meta">
 Kubernetes meta/v1.ObjectMeta
 </a>
 </em>
@@ -4234,6 +4242,40 @@ Template
 <p>Workspaces is a list of WorkspaceBindings from volumes to workspaces.</p>
 </td>
 </tr>
+<tr>
+<td>
+<code>stepOverrides</code><br/>
+<em>
+<a href="#tekton.dev/v1beta1.TaskRunStepOverride">
+[]TaskRunStepOverride
+</a>
+</em>
+</td>
+<td>
+<em>(Optional)</em>
+<p>Overrides to apply to Steps in this TaskRun.
+If a field is specified in both a Step and a StepOverride,
+the value from the StepOverride will be used.
+This field is only supported when the alpha feature gate is enabled.</p>
+</td>
+</tr>
+<tr>
+<td>
+<code>sidecarOverrides</code><br/>
+<em>
+<a href="#tekton.dev/v1beta1.TaskRunSidecarOverride">
+[]TaskRunSidecarOverride
+</a>
+</em>
+</td>
+<td>
+<em>(Optional)</em>
+<p>Overrides to apply to Sidecars in this TaskRun.
+If a field is specified in both a Sidecar and a SidecarOverride,
+the value from the SidecarOverride will be used.
+This field is only supported when the alpha feature gate is enabled.</p>
+</td>
+</tr>
 </table>
 </td>
 </tr>
@@ -4305,6 +4347,75 @@ string
 </tr>
 </tbody>
 </table>
+<h3 id="tekton.dev/v1beta1.ChildStatusReference">ChildStatusReference
+</h3>
+<p>
+(<em>Appears on:</em><a href="#tekton.dev/v1beta1.PipelineRunStatusFields">PipelineRunStatusFields</a>)
+</p>
+<div>
+<p>ChildStatusReference is used to point to the statuses of individual TaskRuns and Runs within this PipelineRun.</p>
+</div>
+<table>
+<thead>
+<tr>
+<th>Field</th>
+<th>Description</th>
+</tr>
+</thead>
+<tbody>
+<tr>
+<td>
+<code>name</code><br/>
+<em>
+string
+</em>
+</td>
+<td>
+<p>Name is the name of the TaskRun or Run this is referencing.</p>
+</td>
+</tr>
+<tr>
+<td>
+<code>pipelineTaskName</code><br/>
+<em>
+string
+</em>
+</td>
+<td>
+<p>PipelineTaskName is the name of the PipelineTask this is referencing.</p>
+</td>
+</tr>
+<tr>
+<td>
+<code>conditionChecks</code><br/>
+<em>
+<a href="#tekton.dev/v1beta1.PipelineRunChildConditionCheckStatus">
+[]PipelineRunChildConditionCheckStatus
+</a>
+</em>
+</td>
+<td>
+<em>(Optional)</em>
+<p>ConditionChecks is the the list of condition checks, including their names and statuses, for the PipelineTask.
+Deprecated: This field will be removed when conditions are removed.</p>
+</td>
+</tr>
+<tr>
+<td>
+<code>whenExpressions</code><br/>
+<em>
+<a href="#tekton.dev/v1beta1.WhenExpression">
+[]WhenExpression
+</a>
+</em>
+</td>
+<td>
+<em>(Optional)</em>
+<p>WhenExpressions is the list of checks guarding the execution of the PipelineTask</p>
+</td>
+</tr>
+</tbody>
+</table>
 <h3 id="tekton.dev/v1beta1.CloudEventCondition">CloudEventCondition
 (<code>string</code> alias)</h3>
 <p>
@@ -4408,7 +4519,7 @@ CloudEventCondition
 <td>
 <code>sentAt</code><br/>
 <em>
-<a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.21/#time-v1-meta">
+<a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.22/#time-v1-meta">
 Kubernetes meta/v1.Time
 </a>
 </em>
@@ -4459,7 +4570,7 @@ int32
 <td>
 <code>metadata</code><br/>
 <em>
-<a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.21/#objectmeta-v1-meta">
+<a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.22/#objectmeta-v1-meta">
 Kubernetes meta/v1.ObjectMeta
 </a>
 </em>
@@ -4618,6 +4729,40 @@ Template
 <p>Workspaces is a list of WorkspaceBindings from volumes to workspaces.</p>
 </td>
 </tr>
+<tr>
+<td>
+<code>stepOverrides</code><br/>
+<em>
+<a href="#tekton.dev/v1beta1.TaskRunStepOverride">
+[]TaskRunStepOverride
+</a>
+</em>
+</td>
+<td>
+<em>(Optional)</em>
+<p>Overrides to apply to Steps in this TaskRun.
+If a field is specified in both a Step and a StepOverride,
+the value from the StepOverride will be used.
+This field is only supported when the alpha feature gate is enabled.</p>
+</td>
+</tr>
+<tr>
+<td>
+<code>sidecarOverrides</code><br/>
+<em>
+<a href="#tekton.dev/v1beta1.TaskRunSidecarOverride">
+[]TaskRunSidecarOverride
+</a>
+</em>
+</td>
+<td>
+<em>(Optional)</em>
+<p>Overrides to apply to Sidecars in this TaskRun.
+If a field is specified in both a Sidecar and a SidecarOverride,
+the value from the SidecarOverride will be used.
+This field is only supported when the alpha feature gate is enabled.</p>
+</td>
+</tr>
 </table>
 </td>
 </tr>
@@ -4718,7 +4863,7 @@ string
 <td>
 <code>startTime</code><br/>
 <em>
-<a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.21/#time-v1-meta">
+<a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.22/#time-v1-meta">
 Kubernetes meta/v1.Time
 </a>
 </em>
@@ -4732,7 +4877,7 @@ Kubernetes meta/v1.Time
 <td>
 <code>completionTime</code><br/>
 <em>
-<a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.21/#time-v1-meta">
+<a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.22/#time-v1-meta">
 Kubernetes meta/v1.Time
 </a>
 </em>
@@ -4746,7 +4891,7 @@ Kubernetes meta/v1.Time
 <td>
 <code>check</code><br/>
 <em>
-<a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.21/#containerstate-v1-core">
+<a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.22/#containerstate-v1-core">
 Kubernetes core/v1.ContainerState
 </a>
 </em>
@@ -4887,7 +5032,7 @@ TaskSpec
 <td>
 <code>Volumes</code><br/>
 <em>
-<a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.21/#volume-v1-core">
+<a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.22/#volume-v1-core">
 []Kubernetes core/v1.Volume
 </a>
 </em>
@@ -5149,6 +5294,22 @@ string
 <p>Bundle url reference to a Tekton Bundle.</p>
 </td>
 </tr>
+<tr>
+<td>
+<code>ResolverRef</code><br/>
+<em>
+<a href="#tekton.dev/v1beta1.ResolverRef">
+ResolverRef
+</a>
+</em>
+</td>
+<td>
+<em>(Optional)</em>
+<p>ResolverRef allows referencing a Pipeline in a remote location
+like a git repo. This field is only supported when the alpha
+feature gate is enabled.</p>
+</td>
+</tr>
 </tbody>
 </table>
 <h3 id="tekton.dev/v1beta1.PipelineResourceBinding">PipelineResourceBinding
@@ -5383,10 +5544,53 @@ string
 </tr>
 </tbody>
 </table>
+<h3 id="tekton.dev/v1beta1.PipelineRunChildConditionCheckStatus">PipelineRunChildConditionCheckStatus
+</h3>
+<p>
+(<em>Appears on:</em><a href="#tekton.dev/v1beta1.ChildStatusReference">ChildStatusReference</a>)
+</p>
+<div>
+<p>PipelineRunChildConditionCheckStatus is used to record the status of condition checks within StatusChildReferences.</p>
+</div>
+<table>
+<thead>
+<tr>
+<th>Field</th>
+<th>Description</th>
+</tr>
+</thead>
+<tbody>
+<tr>
+<td>
+<code>PipelineRunConditionCheckStatus</code><br/>
+<em>
+<a href="#tekton.dev/v1beta1.PipelineRunConditionCheckStatus">
+PipelineRunConditionCheckStatus
+</a>
+</em>
+</td>
+<td>
+<p>
+(Members of <code>PipelineRunConditionCheckStatus</code> are embedded into this type.)
+</p>
+</td>
+</tr>
+<tr>
+<td>
+<code>conditionCheckName</code><br/>
+<em>
+string
+</em>
+</td>
+<td>
+</td>
+</tr>
+</tbody>
+</table>
 <h3 id="tekton.dev/v1beta1.PipelineRunConditionCheckStatus">PipelineRunConditionCheckStatus
 </h3>
 <p>
-(<em>Appears on:</em><a href="#tekton.dev/v1beta1.PipelineRunTaskRunStatus">PipelineRunTaskRunStatus</a>)
+(<em>Appears on:</em><a href="#tekton.dev/v1beta1.PipelineRunChildConditionCheckStatus">PipelineRunChildConditionCheckStatus</a>, <a href="#tekton.dev/v1beta1.PipelineRunTaskRunStatus">PipelineRunTaskRunStatus</a>)
 </p>
 <div>
 <p>PipelineRunConditionCheckStatus returns the condition check status</p>
@@ -5880,7 +6084,7 @@ consume these fields via duck typing.</p>
 <td>
 <code>startTime</code><br/>
 <em>
-<a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.21/#time-v1-meta">
+<a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.22/#time-v1-meta">
 Kubernetes meta/v1.Time
 </a>
 </em>
@@ -5894,7 +6098,7 @@ Kubernetes meta/v1.Time
 <td>
 <code>completionTime</code><br/>
 <em>
-<a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.21/#time-v1-meta">
+<a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.22/#time-v1-meta">
 Kubernetes meta/v1.Time
 </a>
 </em>
@@ -5915,7 +6119,8 @@ map[string]*github.com/tektoncd/pipeline/pkg/apis/pipeline/v1beta1.PipelineRunTa
 </td>
 <td>
 <em>(Optional)</em>
-<p>map of PipelineRunTaskRunStatus with the taskRun name as the key</p>
+<p>Deprecated - use ChildReferences instead.
+map of PipelineRunTaskRunStatus with the taskRun name as the key</p>
 </td>
 </tr>
 <tr>
@@ -5929,7 +6134,8 @@ map[string]*github.com/tektoncd/pipeline/pkg/apis/pipeline/v1beta1.PipelineRunRu
 </td>
 <td>
 <em>(Optional)</em>
-<p>map of PipelineRunRunStatus with the run name as the key</p>
+<p>Deprecated - use ChildReferences instead.
+map of PipelineRunRunStatus with the run name as the key</p>
 </td>
 </tr>
 <tr>
@@ -5973,6 +6179,20 @@ PipelineSpec
 <p>list of tasks that were skipped due to when expressions evaluating to false</p>
 </td>
 </tr>
+<tr>
+<td>
+<code>childReferences</code><br/>
+<em>
+<a href="#tekton.dev/v1beta1.ChildStatusReference">
+[]ChildStatusReference
+</a>
+</em>
+</td>
+<td>
+<em>(Optional)</em>
+<p>list of TaskRun and Run names, PipelineTask names, and API versions/kinds for children of this PipelineRun.</p>
+</td>
+</tr>
 </tbody>
 </table>
 <h3 id="tekton.dev/v1beta1.PipelineRunTaskRunStatus">PipelineRunTaskRunStatus
@@ -6305,6 +6525,20 @@ outputs.</p>
 </tr>
 <tr>
 <td>
+<code>matrix</code><br/>
+<em>
+<a href="#tekton.dev/v1beta1.Param">
+[]Param
+</a>
+</em>
+</td>
+<td>
+<em>(Optional)</em>
+<p>Matrix declares parameters used to fan out this task.</p>
+</td>
+</tr>
+<tr>
+<td>
 <code>workspaces</code><br/>
 <em>
 <a href="#tekton.dev/v1beta1.WorkspacePipelineTaskBinding">
@@ -6688,6 +6922,30 @@ Template
 <td>
 </td>
 </tr>
+<tr>
+<td>
+<code>stepOverrides</code><br/>
+<em>
+<a href="#tekton.dev/v1beta1.TaskRunStepOverride">
+[]TaskRunStepOverride
+</a>
+</em>
+</td>
+<td>
+</td>
+</tr>
+<tr>
+<td>
+<code>sidecarOverrides</code><br/>
+<em>
+<a href="#tekton.dev/v1beta1.TaskRunSidecarOverride">
+[]TaskRunSidecarOverride
+</a>
+</em>
+</td>
+<td>
+</td>
+</tr>
 </tbody>
 </table>
 <h3 id="tekton.dev/v1beta1.PipelineWorkspaceDeclaration">PipelineWorkspaceDeclaration
@@ -6747,6 +7005,109 @@ this field is false and so declared workspaces are required.</p>
 </tr>
 </tbody>
 </table>
+<h3 id="tekton.dev/v1beta1.ResolverName">ResolverName
+(<code>string</code> alias)</h3>
+<p>
+(<em>Appears on:</em><a href="#tekton.dev/v1beta1.ResolverRef">ResolverRef</a>)
+</p>
+<div>
+<p>ResolverName is the name of a resolver from which a resource can be
+requested.</p>
+</div>
+<h3 id="tekton.dev/v1beta1.ResolverParam">ResolverParam
+</h3>
+<p>
+(<em>Appears on:</em><a href="#tekton.dev/v1beta1.ResolverRef">ResolverRef</a>)
+</p>
+<div>
+<p>ResolverParam is a single parameter passed to a resolver.</p>
+</div>
+<table>
+<thead>
+<tr>
+<th>Field</th>
+<th>Description</th>
+</tr>
+</thead>
+<tbody>
+<tr>
+<td>
+<code>Name</code><br/>
+<em>
+string
+</em>
+</td>
+<td>
+<p>Name is the name of the parameter that will be passed to the
+resolver.</p>
+</td>
+</tr>
+<tr>
+<td>
+<code>Value</code><br/>
+<em>
+string
+</em>
+</td>
+<td>
+<p>Value is the string value of the parameter that will be
+passed to the resolver.</p>
+</td>
+</tr>
+</tbody>
+</table>
+<h3 id="tekton.dev/v1beta1.ResolverRef">ResolverRef
+</h3>
+<p>
+(<em>Appears on:</em><a href="#tekton.dev/v1beta1.PipelineRef">PipelineRef</a>, <a href="#tekton.dev/v1beta1.TaskRef">TaskRef</a>)
+</p>
+<div>
+<p>ResolverRef can be used to refer to a Pipeline or Task in a remote
+location like a git repo. This feature is in alpha and these fields
+are only available when the alpha feature gate is enabled.</p>
+</div>
+<table>
+<thead>
+<tr>
+<th>Field</th>
+<th>Description</th>
+</tr>
+</thead>
+<tbody>
+<tr>
+<td>
+<code>resolver</code><br/>
+<em>
+<a href="#tekton.dev/v1beta1.ResolverName">
+ResolverName
+</a>
+</em>
+</td>
+<td>
+<em>(Optional)</em>
+<p>Resolver is the name of the resolver that should perform
+resolution of the referenced Tekton resource, such as &ldquo;git&rdquo;.</p>
+</td>
+</tr>
+<tr>
+<td>
+<code>resource</code><br/>
+<em>
+<a href="#tekton.dev/v1beta1.ResolverParam">
+[]ResolverParam
+</a>
+</em>
+</td>
+<td>
+<em>(Optional)</em>
+<p>Resource contains the parameters used to identify the
+referenced Tekton resource. Example entries might include
+&ldquo;repo&rdquo; or &ldquo;path&rdquo; but the set of params ultimately depends on
+the chosen resolver.</p>
+</td>
+</tr>
+</tbody>
+</table>
 <h3 id="tekton.dev/v1beta1.ResultRef">ResultRef
 </h3>
 <div>
@@ -6822,7 +7183,7 @@ string
 <td>
 <code>Container</code><br/>
 <em>
-<a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.21/#container-v1-core">
+<a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.22/#container-v1-core">
 Kubernetes core/v1.Container
 </a>
 </em>
@@ -6887,7 +7248,7 @@ not have access to it.</p>
 <td>
 <code>ContainerState</code><br/>
 <em>
-<a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.21/#containerstate-v1-core">
+<a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.22/#containerstate-v1-core">
 Kubernetes core/v1.ContainerState
 </a>
 </em>
@@ -6996,7 +7357,7 @@ provided by Container.</p>
 <td>
 <code>Container</code><br/>
 <em>
-<a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.21/#container-v1-core">
+<a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.22/#container-v1-core">
 Kubernetes core/v1.Container
 </a>
 </em>
@@ -7090,7 +7451,7 @@ continue indicates continue executing the rest of the steps irrespective of the
 <td>
 <code>ContainerState</code><br/>
 <em>
-<a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.21/#containerstate-v1-core">
+<a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.22/#containerstate-v1-core">
 Kubernetes core/v1.ContainerState
 </a>
 </em>
@@ -7231,6 +7592,22 @@ string
 <p>Bundle url reference to a Tekton Bundle.</p>
 </td>
 </tr>
+<tr>
+<td>
+<code>ResolverRef</code><br/>
+<em>
+<a href="#tekton.dev/v1beta1.ResolverRef">
+ResolverRef
+</a>
+</em>
+</td>
+<td>
+<em>(Optional)</em>
+<p>ResolverRef allows referencing a Task in a remote location
+like a git repo. This field is only supported when the alpha
+feature gate is enabled.</p>
+</td>
+</tr>
 </tbody>
 </table>
 <h3 id="tekton.dev/v1beta1.TaskResource">TaskResource
@@ -7622,6 +7999,48 @@ string
 </tr>
 </tbody>
 </table>
+<h3 id="tekton.dev/v1beta1.TaskRunSidecarOverride">TaskRunSidecarOverride
+</h3>
+<p>
+(<em>Appears on:</em><a href="#tekton.dev/v1beta1.PipelineTaskRunSpec">PipelineTaskRunSpec</a>, <a href="#tekton.dev/v1beta1.TaskRunSpec">TaskRunSpec</a>)
+</p>
+<div>
+<p>TaskRunSidecarOverride is used to override the values of a Sidecar in the corresponding Task.</p>
+</div>
+<table>
+<thead>
+<tr>
+<th>Field</th>
+<th>Description</th>
+</tr>
+</thead>
+<tbody>
+<tr>
+<td>
+<code>Name</code><br/>
+<em>
+string
+</em>
+</td>
+<td>
+<p>The name of the Sidecar to override.</p>
+</td>
+</tr>
+<tr>
+<td>
+<code>Resources</code><br/>
+<em>
+<a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.22/#resourcerequirements-v1-core">
+Kubernetes core/v1.ResourceRequirements
+</a>
+</em>
+</td>
+<td>
+<p>The resource requirements to apply to the Sidecar.</p>
+</td>
+</tr>
+</tbody>
+</table>
 <h3 id="tekton.dev/v1beta1.TaskRunSpec">TaskRunSpec
 </h3>
 <p>
@@ -7772,6 +8191,40 @@ Template
 <p>Workspaces is a list of WorkspaceBindings from volumes to workspaces.</p>
 </td>
 </tr>
+<tr>
+<td>
+<code>stepOverrides</code><br/>
+<em>
+<a href="#tekton.dev/v1beta1.TaskRunStepOverride">
+[]TaskRunStepOverride
+</a>
+</em>
+</td>
+<td>
+<em>(Optional)</em>
+<p>Overrides to apply to Steps in this TaskRun.
+If a field is specified in both a Step and a StepOverride,
+the value from the StepOverride will be used.
+This field is only supported when the alpha feature gate is enabled.</p>
+</td>
+</tr>
+<tr>
+<td>
+<code>sidecarOverrides</code><br/>
+<em>
+<a href="#tekton.dev/v1beta1.TaskRunSidecarOverride">
+[]TaskRunSidecarOverride
+</a>
+</em>
+</td>
+<td>
+<em>(Optional)</em>
+<p>Overrides to apply to Sidecars in this TaskRun.
+If a field is specified in both a Sidecar and a SidecarOverride,
+the value from the SidecarOverride will be used.
+This field is only supported when the alpha feature gate is enabled.</p>
+</td>
+</tr>
 </tbody>
 </table>
 <h3 id="tekton.dev/v1beta1.TaskRunSpecStatus">TaskRunSpecStatus
@@ -7864,7 +8317,7 @@ string
 <td>
 <code>startTime</code><br/>
 <em>
-<a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.21/#time-v1-meta">
+<a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.22/#time-v1-meta">
 Kubernetes meta/v1.Time
 </a>
 </em>
@@ -7878,7 +8331,7 @@ Kubernetes meta/v1.Time
 <td>
 <code>completionTime</code><br/>
 <em>
-<a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.21/#time-v1-meta">
+<a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.22/#time-v1-meta">
 Kubernetes meta/v1.Time
 </a>
 </em>
@@ -7990,6 +8443,48 @@ TaskSpec
 </tr>
 </tbody>
 </table>
+<h3 id="tekton.dev/v1beta1.TaskRunStepOverride">TaskRunStepOverride
+</h3>
+<p>
+(<em>Appears on:</em><a href="#tekton.dev/v1beta1.PipelineTaskRunSpec">PipelineTaskRunSpec</a>, <a href="#tekton.dev/v1beta1.TaskRunSpec">TaskRunSpec</a>)
+</p>
+<div>
+<p>TaskRunStepOverride is used to override the values of a Step in the corresponding Task.</p>
+</div>
+<table>
+<thead>
+<tr>
+<th>Field</th>
+<th>Description</th>
+</tr>
+</thead>
+<tbody>
+<tr>
+<td>
+<code>Name</code><br/>
+<em>
+string
+</em>
+</td>
+<td>
+<p>The name of the Step to override.</p>
+</td>
+</tr>
+<tr>
+<td>
+<code>Resources</code><br/>
+<em>
+<a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.22/#resourcerequirements-v1-core">
+Kubernetes core/v1.ResourceRequirements
+</a>
+</em>
+</td>
+<td>
+<p>The resource requirements to apply to the Step.</p>
+</td>
+</tr>
+</tbody>
+</table>
 <h3 id="tekton.dev/v1beta1.TaskSpec">TaskSpec
 </h3>
 <p>
@@ -8069,7 +8564,7 @@ source mounted into /workspace.</p>
 <td>
 <code>volumes</code><br/>
 <em>
-<a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.21/#volume-v1-core">
+<a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.22/#volume-v1-core">
 []Kubernetes core/v1.Volume
 </a>
 </em>
@@ -8083,7 +8578,7 @@ steps of the build.</p>
 <td>
 <code>stepTemplate</code><br/>
 <em>
-<a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.21/#container-v1-core">
+<a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.22/#container-v1-core">
 Kubernetes core/v1.Container
 </a>
 </em>
@@ -8195,7 +8690,7 @@ Kubernetes meta/v1.Duration
 <h3 id="tekton.dev/v1beta1.WhenExpression">WhenExpression
 </h3>
 <p>
-(<em>Appears on:</em><a href="#tekton.dev/v1beta1.PipelineRunRunStatus">PipelineRunRunStatus</a>, <a href="#tekton.dev/v1beta1.PipelineRunTaskRunStatus">PipelineRunTaskRunStatus</a>, <a href="#tekton.dev/v1beta1.SkippedTask">SkippedTask</a>)
+(<em>Appears on:</em><a href="#tekton.dev/v1beta1.ChildStatusReference">ChildStatusReference</a>, <a href="#tekton.dev/v1beta1.PipelineRunRunStatus">PipelineRunRunStatus</a>, <a href="#tekton.dev/v1beta1.PipelineRunTaskRunStatus">PipelineRunTaskRunStatus</a>, <a href="#tekton.dev/v1beta1.SkippedTask">SkippedTask</a>)
 </p>
 <div>
 <p>WhenExpression allows a PipelineTask to declare expressions to be evaluated before the Task is run
@@ -8298,7 +8793,7 @@ for this binding (i.e. the volume will be mounted at this sub directory).</p>
 <td>
 <code>volumeClaimTemplate</code><br/>
 <em>
-<a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.21/#persistentvolumeclaim-v1-core">
+<a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.22/#persistentvolumeclaim-v1-core">
 Kubernetes core/v1.PersistentVolumeClaim
 </a>
 </em>
@@ -8313,7 +8808,7 @@ The PipelineRun controller is responsible for creating a unique claim for each i
 <td>
 <code>persistentVolumeClaim</code><br/>
 <em>
-<a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.21/#persistentvolumeclaimvolumesource-v1-core">
+<a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.22/#persistentvolumeclaimvolumesource-v1-core">
 Kubernetes core/v1.PersistentVolumeClaimVolumeSource
 </a>
 </em>
@@ -8328,7 +8823,7 @@ PersistentVolumeClaim in the same namespace. Either this OR EmptyDir can be used
 <td>
 <code>emptyDir</code><br/>
 <em>
-<a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.21/#emptydirvolumesource-v1-core">
+<a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.22/#emptydirvolumesource-v1-core">
 Kubernetes core/v1.EmptyDirVolumeSource
 </a>
 </em>
@@ -8344,7 +8839,7 @@ Either this OR PersistentVolumeClaim can be used.</p>
 <td>
 <code>configMap</code><br/>
 <em>
-<a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.21/#configmapvolumesource-v1-core">
+<a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.22/#configmapvolumesource-v1-core">
 Kubernetes core/v1.ConfigMapVolumeSource
 </a>
 </em>
@@ -8358,7 +8853,7 @@ Kubernetes core/v1.ConfigMapVolumeSource
 <td>
 <code>secret</code><br/>
 <em>
-<a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.21/#secretvolumesource-v1-core">
+<a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.22/#secretvolumesource-v1-core">
 Kubernetes core/v1.SecretVolumeSource
 </a>
 </em>
diff --git a/go.mod b/go.mod
index fd8da620788..9f1ca602826 100644
--- a/go.mod
+++ b/go.mod
@@ -10,7 +10,7 @@ replace (
 )
 
 require (
-	github.com/abayer/gen-crd-api-reference-docs v0.999.0
+	github.com/abayer/gen-crd-api-reference-docs v0.999.0 // Waiting for https://github.com/ahmetb/gen-crd-api-reference-docs/pull/43/files to merge
 	github.com/cloudevents/sdk-go/v2 v2.5.0
 	github.com/containerd/containerd v1.5.10
 	github.com/ghodss/yaml v1.0.0
diff --git a/go.sum b/go.sum
index a47271ae130..f3e25f7c97b 100644
--- a/go.sum
+++ b/go.sum
@@ -2136,7 +2136,6 @@ k8s.io/gengo v0.0.0-20210813121822-485abfe95c7c/go.mod h1:FiNAH4ZV3gBg2Kwh89tzAE
 k8s.io/gengo v0.0.0-20211129171323-c02415ce4185 h1:TT1WdmqqXareKxZ/oNXEUSwKlLiHzPMyB0t8BaFeBYI=
 k8s.io/gengo v0.0.0-20211129171323-c02415ce4185/go.mod h1:FiNAH4ZV3gBg2Kwh89tzAEV2be7d5xI0vBa/VySYy3E=
 k8s.io/klog v0.2.0/go.mod h1:Gq+BEi5rUBO/HRz0bTSXDUcqjScdoY3a9IHpCEIOOfk=
-k8s.io/klog v0.3.1/go.mod h1:Gq+BEi5rUBO/HRz0bTSXDUcqjScdoY3a9IHpCEIOOfk=
 k8s.io/klog v1.0.0 h1:Pt+yjF5aB1xDSVbau4VsWe+dQNzA0qv1LlXdC2dF6Q8=
 k8s.io/klog v1.0.0/go.mod h1:4Bi6QPql/J/LkTDqv7R/cd3hPo4k2DG6Ptcz060Ez5I=
 k8s.io/klog/v2 v2.0.0/go.mod h1:PBfzABfn139FHAV07az/IF9Wp1bkk3vpT2XSJ76fSDE=
diff --git a/hack/reference-docs-gen-config.json b/hack/reference-docs-gen-config.json
index 1cf8db3503c..3eae81ee699 100644
--- a/hack/reference-docs-gen-config.json
+++ b/hack/reference-docs-gen-config.json
@@ -13,7 +13,7 @@
         },
         {
             "typeMatchPrefix": "^k8s\\.io/(api|apimachinery/pkg/apis)/",
-            "docsURLTemplate": "https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.21/#{{lower .TypeIdentifier}}-{{arrIndex .PackageSegments -1}}-{{arrIndex .PackageSegments -2}}"
+            "docsURLTemplate": "https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.22/#{{lower .TypeIdentifier}}-{{arrIndex .PackageSegments -1}}-{{arrIndex .PackageSegments -2}}"
         },
         {
             "typeMatchPrefix": "^knative\\.dev/pkg/apis/duck",
diff --git a/hack/update-reference-docs.sh b/hack/update-reference-docs.sh
index e7c6305f70a..e40dbd86473 100755
--- a/hack/update-reference-docs.sh
+++ b/hack/update-reference-docs.sh
@@ -24,3 +24,4 @@ go run github.com/abayer/gen-crd-api-reference-docs \
     -api-dir "github.com/tektoncd/pipeline/pkg/apis" \
     -template-dir "./hack/reference-docs-template" \
     -out-file "./docs/pipeline-api.md"
+sed -i '1s/^/<!--\n---\ntitle: Pipeline API\nlinkTitle: Pipeline API\nweight: 1000\n---\n-->\n\n/' ./docs/pipeline-api.md