Merge branch 'russell/edit-jenkins-intructions' into 'master'

Edited GitLab-Jenkins integration instructions

See merge request gitlab-org/gitlab!31560

doc/integration/jenkins.md

@@ -99,25 +99,29 @@ Set up the Jenkins project you’re going to run your build on.
 1. Check the following checkboxes:
    - **Accepted Merge Request Events**
    - **Closed Merge Request Events**
-1. If you created a **Freestyle** project, choose Publish build status to GitLab in the Post-build Actions section.
-   If you created a **Pipeline** project, you must use a pipeline script to update the status on
-   GitLab. The following is an example pipeline script:
-
-   ```plaintext
-   pipeline {
-      agent any
-
-      stages {
-         stage('gitlab') {
-            steps {
-               echo 'Notify GitLab'
-               updateGitlabCommitStatus name: 'build', state: 'pending'
-               updateGitlabCommitStatus name: 'build', state: 'success'
+1. Specify how build status is reported to GitLab:
+   - If you created a **Freestyle** project, in the **Post-build Actions** section, choose
+   **Publish build status to GitLab**.
+   - If you created a **Pipeline** project, you must use a Jenkins Pipeline script to update the status on
+   GitLab.
+
+     Example Jenkins Pipeline script:
+
+      ```groovy
+      pipeline {
+         agent any
+
+         stages {
+            stage('gitlab') {
+               steps {
+                  echo 'Notify GitLab'
+                  updateGitlabCommitStatus name: 'build', state: 'pending'
+                  updateGitlabCommitStatus name: 'build', state: 'success'
+               }
             }
          }
       }
-   }
-   ```
+      ```
 
 ## Configure the GitLab project