From APIDesign
A part of lifecycle of an [[API] is called deprecation. Once an API is no longer recommended (either being slow, or memory hungry or there is a more suitable replacement), it should be marked as deprecated to signal that new code shall avoid its usage.