Changes base on Tech Writer review

- Switch to showing shell script example rather than
yaml file example

doc/api/jobs.md

@@ -400,13 +400,12 @@ Retrieve the job that generated a job token.
 GET /job
 ```
 
-Examples (within GitLab CI YAML)
+Examples (must run as part of the [`script`](../ci/yaml/index.md#script) section of a [CI/CD job](../ci/jobs/index.md)):
 
-```yaml
-  script:
-    - 'curl --header "Authorization: Bearer $CI_JOB_TOKEN" "${CI_API_V4_URL}/job"'
-    - 'curl --header "JOB-TOKEN: $CI_JOB_TOKEN" "${CI_API_V4_URL}/job"'
-    - 'curl "${CI_API_V4_URL}/job?job_token=$CI_JOB_TOKEN"'
+```shell
+curl --header "Authorization: Bearer $CI_JOB_TOKEN" "${CI_API_V4_URL}/job"
+curl --header "JOB-TOKEN: $CI_JOB_TOKEN" "${CI_API_V4_URL}/job"
+curl "${CI_API_V4_URL}/job?job_token=$CI_JOB_TOKEN"
 ```
 
 Example of response