Switch to 'secret variable' name in variables endpoint API docs

Open username-removed-382401 requested to merge gdubicki/gitlab-ce:patch-11 into master

Both web UI as well as other docs use 'secret variable' name instead of currently used 'build variable' in the API docs. This MR is to unify this by changing the API docs.