move the deprecation notice higher, and note it in the abstract too

feedback requested please!

@shadowcat-mst @perigrin