fix(api/gitlab/v1): rename fix and docs update

Adds preliminary documentation on how to use the rename repository endpoint in preparation for tackling #925 (closed), #1035 (closed) & #924 (moved)