Adds documentation for the allow_failure keyword for the CI.
allow_failure
Closes https://gitlab.com/gitlab-org/gitlab-ce/issues/17669