Documentation is part of engineering. Hire engineers rather than two bit coders. They already have the culture burned in. Works for us. Most people not up to i

Documentation is part of engineering. Hire engineers rather than two bit coders. They already have the culture burned in. Works for us. Most people not up to it I.e. find it boring or can't put a sentence together bail in a month because they can't get their code through the review cycle. They are made well aware of the requirements at interview time. We're in financial sector so sound engineering and documentation stops us getting in deep shit. Case in point recently, one of our service providers broke their service API silently. We had their documentation, contracts etc set in stone in source control, named and dated as were our integration paths. When they pointed the finger at us, we were covered. The small detail was recorded (1 penny rounding method) which meant we could trace it instantly, pop open our log4j dumps and found that they sent the value wrong. Not only that, we raised it to start with because our constraints were documented and assertions were in place.