Add documentation for tier variant

The component has a defined variant tier that has not been added to all aspects of the documentation yet.

• Refs: https://gitlab.com/gitlab-org/gitlab-ui/-/blob/main/src/utils/constants.js#L32

Changelog: fixed