Docs: clarify Pipelines API scope behavior for branches and tags

Doby Baxterrequested to merge
gitlab-community/gitlab-org/gitlab:docs/pipelines-scope-clarification-v2 into master

Document that the branches and tags scope values return only the latest pipeline per ref.

Closes #589123

Merge request reports