Sem dúvidas a documentação é crucial, hoje em dia existem vários programas que auxiliam na documentação, realmente acho que é muita falta de vontade por falta do programador não documentar seus códigos. Em relação ao uso de $_ nas variáveis já foi muito discutido e todos chegaram ao acordo que elas deveriam ser evitadas mas eu concordo com o uso de letra maíuscula como "separador" de nomes compostos. E Eric você deve tomar cuidado ao programar em mais de uma linguagem principalmente se forem duas que usam POO como é o seu caso pois são linguagens diferentes e tem padrões diferentes, alguma confusão pode gerar uma brecha na segurança!