Taking your lock reference as an analogy, you could go out and buy a $100 lock to secure your house. Will that prevent someone from breaking into your house? Probably not, and that is from a device whose sole purpose is protection. You would have to spend orders of magnitude more for total security of your house.
Now applying that to software, people spend $100 on a M$ OS, which was not even created solely for protection and people expect it to protect them perfectly. Why should we expect more for our $100?
I don't pay my team to write documentation. I pay them to develop solutions to business problems. If you need some docs to support that development then produce no more and no less than what is needed to do the work. If the documentation is out of date in a month, then you should be questioning its usefulness and the need to maintain it. If it is really necessary then it tends to stay up-to-date.
Slashdot Mirror
Taking your lock reference as an analogy, you could go out and buy a $100 lock to secure your house. Will that prevent someone from breaking into your house? Probably not, and that is from a device whose sole purpose is protection. You would have to spend orders of magnitude more for total security of your house. Now applying that to software, people spend $100 on a M$ OS, which was not even created solely for protection and people expect it to protect them perfectly. Why should we expect more for our $100?
I don't pay my team to write documentation. I pay them to develop solutions to business problems. If you need some docs to support that development then produce no more and no less than what is needed to do the work. If the documentation is out of date in a month, then you should be questioning its usefulness and the need to maintain it. If it is really necessary then it tends to stay up-to-date.