- job:
    name: run-tox
    description: |
      Jobs can be documented in the same way as roles. Just note the difference
      in the name of the Sphinx directive.
      For a proper formatting, use the <code>|</code> format for YAML multiline
      Strings.

      **Job variables**

      .. zuul:jobvar:: path
         :default: .

         Path were to run tox. If not set, the current directory will be used.

      .. zuul:jobvar:: envlist
         :type: list

         List of all tox envs which should be executed