### Description of issue We need the ability to mark functions as "deprecated" in metadata so that the codegenerator does the appropriate thing: * DeprecationWarning * remove from ReadTheDocs or mark it as deprecated This is needed for #1403