C++ tries to guard against Murphy, not Machiavelli.
Documentation is a love letter that you write to your future self.
Programming is a Dark Art, and it always will be. The programmer is fighting against the two most destructive forces in the universe: entropy and human stupidity. These are not things you can overcome with a "methodology" or on a schedule.