it shoudl be placed right below the title, use something like this:

    .. warning: This API is deprecated and will be removed in the future.