Add usage of `default:`

What does this MR do?

This documents the usage of default: and marks previous syntax as deprecated

Closes https://gitlab.com/gitlab-org/gitlab-ce/issues/63351

Does this MR meet the acceptance criteria?

Conformity

• Documentation created/updated or follow-up review issue created