Artifacts documentation inconsistency

In the documentation of the 'artifacts' feature the first sentence is expressing that artifacts could be only uploaded to Gitlab, if the related job succeeds. https://docs.gitlab.com/ee/administration/job_artifacts.html

@haynes told me that on the CI yaml documentation there are possible solutions how to use artifacts when the job fails. https://docs.gitlab.com/ee/ci/yaml/#artifactswhen

Also the first sentence of the artifacts part in CI yaml documentation mentions that a artifact is only uploaded if the job succeeds. https://docs.gitlab.com/ee/ci/yaml/#artifacts

So in general these occurrences should be updated, because artifacts could be uploaded on failure, on success, or always. Probably there are some more occurrences that have to be updated, but I was not able to find them.