Creo que deberías documentarte más al respecto.
Es falso de que se tomen únicamente los comentarios cercanos a un método o función.
Puedes comentar cualquier cosa haciendo uso de dichos comentarios tipo PHPDoc/JavaDoc, por favor, lee la documentación antes de asegurar falsedades.
PDTA: tu pregunta nada tiene que ver con el foro de PHP, aunque tu código sea PHP aquí se discuten temas técnicos, problemas y no documentación de software que es algo más general.