DEV Community

Discussion on: Code Smell 05 - Comment Abusers

Collapse
 
1e4_ profile image
Ian

Everything in this post points to PHP.

I heavily disagree with no documentation. Just because you know what's going on doesn't mean someone that comes to a project later on.

Thread Thread
 
mcsee profile image
Maxi Contieri

That's why you need to write declarative methods, classes and attributes.

Methods are alive. They are maintained . They run with the tests.

Nobody maintains documentation. And nobody reads them

Thread Thread
 
mcsee profile image
Maxi Contieri

That's why tests are for.

They are alive, they are maintained and they don't lie