Есть ли общие требования к комментированию кода?
Ну по современным тенденциям код не комментируют, а пишут документацию.  
https://www.phpdoc.org
Сильно связано с конкретными языковыми традициями.
Дело в том, что современные языки программирования самодокументирующие.
Читаем как пример как нужно комментировать:
https://github.com/golang/go/blob/master/src/time/...