Add information on API support

[kennknowles]

Add information to the web site about API and version support, including the meaning of experimental and deprecated annotations. Currently this information only exists in API docs.

Imported from Jira BEAM-4550. Original Jira may contain additional context.
Reported by: altay.