(PUP-1799) Add warning messages to docs

These APIs are still under development, but will be part of the next
release. This tries to give any users warning that they might change at
any time.