tf-m-build-docs: Update from upstream

Signed-off-by: Paul Sokolovsky <paul.sokolovsky@linaro.org>
Change-Id: I19d5352a88c2af0b2ee1b65e4d8a08f9ebc05cab
diff --git a/tf-m-build-docs.yaml b/tf-m-build-docs.yaml
index b28a4c9..a525b17 100644
--- a/tf-m-build-docs.yaml
+++ b/tf-m-build-docs.yaml
@@ -1,5 +1,5 @@
 #-------------------------------------------------------------------------------
-# Copyright (c) 2020-2021, Arm Limited. All rights reserved.
+# Copyright (c) 2020-2022, Arm Limited. All rights reserved.
 #
 # SPDX-License-Identifier: BSD-3-Clause
 #
@@ -7,14 +7,14 @@
 
 - job:
     name: tf-m-build-docs
-    description: 'Staging - Builds documentation'
+    description: 'Builds documentation'
     project-type: pipeline
     disabled: false
     sandbox: true
     concurrent: true
     properties:
       - build-discarder:
-          days-to-keep: 5
+          days-to-keep: 15
           num-to-keep: 45
       - copyartifact:
           projects: "tf-m-build-and-test"
@@ -23,33 +23,36 @@
           name: 'GERRIT_REFSPEC'
           default: 'refs/heads/main'
           description: |
-            For use when triggering with unmerged Gerrit changes.
+            Specify which TF-M version to use
+            refs/heads/<branch_name> : Pick up latest HEAD on branch
+            TAG_NAME                 : Pick up a tagged version
+            full commit hash         : Pick up a specific commit
       - string:
           name: 'GERRIT_BRANCH'
           default: 'main'
           description: |
-            For use when triggering with unmerged Gerrit changes.
+            TF-M branch.
       - string:
           name: 'GERRIT_HOST'
           default: ''
           description: |
-            For use when triggering with unmerged Gerrit changes.
+            No need to change.
       - string:
           name: 'GERRIT_PATCHSET_REVISION'
           default: ''
           description: |
-            For use when triggering with unmerged Gerrit changes.
+            No need to change.
       - string:
           name: 'GERRIT_CHANGE_NUMBER'
           default: ''
           description: |
-            For use when triggering with unmerged Gerrit changes.
+            No need to change.
       - string:
           name: 'CODE_REPO'
           default: 'https://review.trustedfirmware.org/TF-M/trusted-firmware-m'
       - string:
           name: 'CI_SCRIPTS_REPO'
-          default: 'https://review.trustedfirmware.org/next/ci/tf-m-ci-scripts'
+          default: 'https://git.trustedfirmware.org/ci/tf-m-ci-scripts'
       - string:
           name: 'CI_SCRIPTS_BRANCH'
           default: 'master'
@@ -65,6 +68,7 @@
             url: '$CI_SCRIPTS_REPO'
             branches:
             - '$CI_SCRIPTS_BRANCH'
+            refspec: '+refs/heads/*:refs/remotes/origin/* +refs/changes/*:refs/remotes/origin/refs/changes/*'
             credentials-id: GIT_SSH_KEY
             wipe-workspace: false
       script-path: jenkins/build-docs.jpl