Documentation: Add a "Heads Up" Section

[rglover]

This would be super handy. The idea is to have a heavily-styled block that calls out 1 or more "heads up" notes so you're aware before you even touch the API. This way you don't miss important stuff buried in the text.