CI variable doc improvements

Closes #36942, gitlab-com/support/docs#13, and bprescott_/todo#48

See merge request gitlab-org/gitlab!29473