Good article and thoughts. I've always struggled in trying to determine the best place for documentation that explains business logic, or "Why are we doing it this way." Maybe documenting that in unit tests is a good step.