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.