- job:
    name: tf-a-lts-release-docs
    node: docker-amd64-tf-a-jammy
    project-type: freestyle
    concurrent: true
    disabled: false
    defaults: global
    description: |
      Publish TF-A LTS docs for a release on ReadTheDocs site
    properties:
        - build-discarder:
            days-to-keep: 365
            num-to-keep: 50
    parameters:
        - string:
            name: GERRIT_HOST
            default: 'review.trustedfirmware.org'
        - string:
            name: GERRIT_PROJECT
            default: 'sandbox/pfalcon/trusted-firmware-a'
            description: |
              TF-A Git project
        - string:
            name: GERRIT_BRANCH
            default: ''
            description: |
              Git branch (e.g. lts-v2.8)
        - string:
            name: GERRIT_REFNAME
            default: ''
            description: |
              Git refname
        - string:
            name: RELEASE_TAG
            default: '--latest'
            description: |
              Release git tag, e.g. 'lts-v2.8.10'
        - bool:
            name: SANDBOX_RUN
            default: true
            description: |
              Run sandbox simulation of a release. Uncheck this only after
              running simulation and checking that everything is correct!
    wrappers:
    - timestamps
    - timeout:
        timeout: 60
        fail: true
    - credentials-binding:
      - text:
          credential-id: TF-A-RTD-API-TOKEN
          variable: RTD_API_TOKEN
      - text:
          credential-id: Trusted_Firmware_ReadTheDocs_Token
          variable: RTD_WEBHOOK_SECRET
      - text:
          credential-id: TFA_SANDBOX_RTD_WEBHOOK_SECRET
          variable: TFA_SANDBOX_RTD_WEBHOOK_SECRET
      - text:
          credential-id: PFALCON_RTD_API_TOKEN
          variable: PFALCON_RTD_API_TOKEN
      - text:
          credential-id: PFALCON_RTD_WEBHOOK_SECRET
          variable: PFALCON_RTD_WEBHOOK_SECRET
    builders:
    - shell:
        !include-raw: scripts/tf-a-lts-docs-watcher.sh