Look at experimental decorator.

[davidorme]

I would prefer to review and explicitly mark all experimental features in 2.0.0. It would be easier to do that if we had a decorator to add to classes, methods and functions.

The decorator should:

• generate a warning when the feature is used, and
• extend the docstrings to add an admonition.