Document `except:changes` behaviour if other paths are changed as well

The issue Run jobs only/except when there are changes for a given path or file was closed with updated documentation (https://docs.gitlab.com/ee/ci/yaml/#only-changes) that provides one example.

For me it is still unclear what happens when I use except and changes. Imagine the following .gitlab-ci.yml:

docker build:
  script: docker build -t my-image:$CI_COMMIT_REF_SLUG .
  except:
    changes:
      - doc/*

If I push a change that changes only something in the doc-folder, I assume no job is created.

But if I push a change that changes not only doc/* but also docker/scripts/* does it still create a pipeline? If this is (not) the case, it should be documented, because it would be hard in the current implementation to create that behavior easily.

New doc or update?

  • New documentation
  • Update existing documentation

Checklists

Product Manager

  • Add the correct labels
  • Add the correct milestone
  • Indicate the correct document/directory for this feature
  • Fill the doc blurb below

Documentation blurb

  • Doc title

  • Feature overview/description

  • Feature use cases

Developer

  • Copy the doc blurb above and paste it into the doc
  • Write the tutorial - explain how to use the feature
  • Submit the MR using the appropriate MR description template
Edited by Ben Bodenmiller