move the deprecation notice higher, and note it in the abstract too
Merge pull request #1 from karenetheridge/topic/better_deprecation_notice

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