Clarify API doc on delete project artifacts

What does this MR do and why?

Clarify API doc on delete project artifacts. Add a note that by default, artifacts from the latest pipeline per ref is kept.

Screenshots or screen recordings

These are strongly recommended to assist reviewers and reduce the time to merge your change.

How to set up and validate locally

Numbered steps to set up and validate the change are strongly suggested.

MR acceptance checklist

This checklist encourages us to confirm any changes have been analyzed to reduce risks in quality, performance, reliability, security, and maintainability.

• I have evaluated the MR acceptance checklist for this MR.