Adds spam/CAPTCHA dev docs for REST API

What does this MR do?

See Issue: Write Developer Docs for Spam/CAPTCHA support

Second pass at docs, REST API and cleanup

NOTE: See corresponding merge request to update navigation in docs project: gitlab-docs!2514 (merged)