The proper way to mark a method as deprecated is using the ``@deprecated`` phpdoc tag. this way, IDEs can wanr you when using it