Improve GitLab Shell documentation

The GitLab Shell documentation is currently a README.

This issue will (in sequential steps):

• improve the quality of these existing docs
• move them into the main documentation repo

See also: #544 (closed)