Add an API styleguide

What does this MR do?

This adds a styleguide for API development. Spinned-of from https://gitlab.com/gitlab-org/gitlab-ce/merge_requests/6860#note_16922017.

Does this MR meet the acceptance criteria?

• Documentation created/updated