Add documentation about timeout format

docs/taskruns.md

@@ -151,10 +151,22 @@ The `paths` field can be used to [override the paths to a resource](./resources.
 
 ### Configuring Default Timeout
 
-You can configure the default timeout by changing the value of `default-timeout-minutes`
-in [`config/config-defaults.yaml`](./../config/config-defaults.yaml). The default timeout
-is 60 minutes, if `default-timeout-minutes` is not available. There is no timeout by
-default, if `default-timeout-minutes` is set to 0.
+You can configure the default timeout by changing the value of
+`default-timeout-minutes` in
+[`config/config-defaults.yaml`](./../config/config-defaults.yaml).
+
+The `timeout` format is a `duration` as validated by Go's
+[`ParseDuration`](https://golang.org/pkg/time/#ParseDuration), valid format for
+examples are :
+
+- `1h30m`
+- `1h`
+- `1m`
+- `60s`
+
+The default timeout is 60 minutes, if `default-timeout-minutes` is not
+available. There is no timeout by default, if `default-timeout-minutes` is set
+to 0.
 
 ### Service Account
 

examples/pipelineruns/no-ci/pipeline-timeout.yaml

@@ -0,0 +1,56 @@
+apiVersion: tekton.dev/v1alpha1
+kind: Task
+metadata:
+  name: task-echo-message
+spec:
+  inputs:
+    params:
+      - name: MESSAGE
+        type: string
+        default: "Hello World"
+  steps:
+    - name: echo
+      image: ubuntu
+      command:
+        - sleep 90s
+      args:
+        - "$(inputs.params.MESSAGE)"
+---
+
+apiVersion: tekton.dev/v1alpha1
+kind: PipelineRun
+metadata:
+  name: pipelinerun-timeout
+spec:
+  # 1 hour and half timeout
+  timeout: 1h30m
+  pipelineSpec:
+    params:
+      - name: MORNING_GREETINGS
+        description: "morning greetings, default is Good Morning!"
+        type: string
+        default: "Good Morning!"
+      - name: NIGHT_GREETINGS
+        description: "Night greetings, default is Good Night!"
+        type: string
+        default: "Good Night!"
+    tasks:
+      # Task to display morning greetings
+      - name: echo-good-morning
+        taskRef:
+          name: task-echo-message
+        params:
+          - name: MESSAGE
+            value: $(params.MORNING_GREETINGS)
+      # Task to display night greetings
+      - name: echo-good-night
+        taskRef:
+          name: task-echo-message
+        params:
+          - name: MESSAGE
+            value: $(params.NIGHT_GREETINGS)
+  params:
+    - name: MORNING_GREETINGS
+      value: "Good Morning, Bob!"
+    - name: NIGHT_GREETINGS
+      value: "Good Night, Bob!"