Add note about combining `allow_failure` and `on_failure`
What does this MR do and why?
Describe in detail what your merge request does and why.
If allow_failure: true
then the job, even if failed, is seen as
passed. And with that subsequent
jobs with when: on_failure
referring
to that "failed" job, won't be triggered.