Предположим, что мы перенесли эту функцию, например, в другой класс (с использованием автозагрузки) и хотим указать другим программистам, что лучше использовать другой метод, тогда можно оформить комментарии следующим образом (phpDocumentor):
/**
* Определит принадлежит ли ОС к семье Windows
* (определение операционной системы)
*
* @deprecated
* @see \Server\OS::isWindows() - удобнее вызывать этот метод
*/
function is_windows() {