Add a way to mark APIs as experimental, deprecated, or stable in the API documentation #62

It's currently implied that everything is experimental, but that won't always be the case (and some parts are definitely de-facto-stable).

The docs should probably explain what exactly those labels mean in this context, too.