The LoB principle dictates that the behavior of a unit of code should be as obvious as possible by looking only at that unit of code. But I think something is missing from this discussion.
PHP
What nobody tells developers about documentation
Users don’t know what your product does, how to use it, or why they would use it. You need docs to explain this. Read more