Add more information and refactor format of Avatar API topic

What does this MR do?

Provides more information, and updates the format of the Avatar API topic.

Related issues

Relates to: https://gitlab.com/gitlab-org/gitlab-ce/issues/10421.

Author's checklist

• Apply the correct labels and milestone

Review checklist

• Your team's review (required)
• Technical writer's review (required)