Make job API docs consistent
Make job API docs consistent

In https://gitlab.com/gitlab-org/gitlab-ce/merge_requests/23538 when
adding a new endpoint some docs incossintenies were pointed out.

mmkassem/gitlabhq,dreampet/gitlab,mmkassem/gitlabhq,stoplightio/gitlabhq,dreampet/gitlab,axilleas/gitlabhq,iiet/iiet-git,stoplightio/gitlabhq,iiet/iiet-git,mmkassem/gitlabhq,axilleas/gitlabhq,axilleas/gitlabhq,mmkassem/gitlabhq,stoplightio/gitlabhq,axilleas/gitlabhq,dreampet/gitlab,stoplightio/gitlabhq,dreampet/gitlab,iiet/iiet-git,iiet/iiet-git