/** */ - PHPDoc
// - обычные коментарии
первое используется для помощи IDE (и себя любимого) и для генерации документации
второе - по обстоятельствам, когда нужно прокоментировать какую-то неясную часть кода, логики, пояснить свои дейсвия, выбор алгоритма, etc...
ps
при этом всем главное не забывать давать внятные имена переменным, методам, объектам и тд