Refactor README API documentation
Waiting for https://gitlab.com/gitlab-org/gitlab-ce/merge_requests/2435 to be merged.
Do not update/delete: Banner broadcast message test data
Do not update/delete: Notification broadcast message test data
Waiting for https://gitlab.com/gitlab-org/gitlab-ce/merge_requests/2435 to be merged.