Cleanup CI variables table and add a deprecation note
Addresses discussion starting from https://gitlab.com/gitlab-org/gitlab-ce/merge_requests/9756#note_25041251
Addresses discussion starting from https://gitlab.com/gitlab-org/gitlab-ce/merge_requests/9756#note_25041251