diff --git a/docs/pipelineruns.md b/docs/pipelineruns.md
index ec3efab4136..0a804e310e5 100644
--- a/docs/pipelineruns.md
+++ b/docs/pipelineruns.md
@@ -217,6 +217,8 @@ metadata:
 spec:
   tasks:
     - name: task
+      taskRef:
+        name: task
 ---
 apiVersion: tekton.dev/v1 # or tekton.dev/v1beta1
 kind: PipelineRun
diff --git a/docs/workspaces.md b/docs/workspaces.md
index 9728bf1be6a..9032f9eaf80 100644
--- a/docs/workspaces.md
+++ b/docs/workspaces.md
@@ -486,7 +486,7 @@ Using a `configMap` as a `Workspace` has the following limitations:
 ```yaml
 workspaces:
   - name: myworkspace
-    configmap:
+    configMap:
       name: my-configmap
 ```