diff --git a/docs/pipelineruns.md b/docs/pipelineruns.md
index 7d905432514..85cd6bd8979 100644
--- a/docs/pipelineruns.md
+++ b/docs/pipelineruns.md
@@ -178,7 +178,7 @@ so long as the artifact adheres to the [contract](tekton-bundle-contracts.md).
 
 A `pipelineRef` field may specify a Pipeline in a remote location such as git.
 Support for specific types of remote will depend on the Resolvers your
-cluster's operator has installed. The below example demonstrates
+cluster's operator has installed. For more information please check the [Tekton resolution repo](https://github.com/tektoncd/resolution). The below example demonstrates
 referencing a Pipeline in git:
 
 ```yaml
@@ -188,9 +188,9 @@ spec:
     resource:
     - name: url
       value: https://github.com/tektoncd/catalog.git
-    - name: commit
+    - name: revision
       value: abc123
-    - name: path
+    - name: pathInRepo
       value: /pipeline/buildpacks/0.1/buildpacks.yaml
 ```
 
diff --git a/docs/taskruns.md b/docs/taskruns.md
index 0df3fad5ce0..46b32f179c3 100644
--- a/docs/taskruns.md
+++ b/docs/taskruns.md
@@ -169,7 +169,7 @@ cli *(coming soon)*.
 
 A `taskRef` field may specify a Task in a remote location such as git.
 Support for specific types of remote will depend on the Resolvers your
-cluster's operator has installed. The below example demonstrates
+cluster's operator has installed. For more information please check the [Tekton resolution repo](https://github.com/tektoncd/resolution). The below example demonstrates
 referencing a Task in git:
 
 ```yaml
@@ -179,9 +179,9 @@ spec:
     resource:
     - name: url
       value: https://github.com/tektoncd/catalog.git
-    - name: commit
+    - name: revision
       value: abc123
-    - name: path
+    - name: pathInRepo
       value: /task/golang-build/0.3/golang-build.yaml
 ```