Forums
Jun 22Classic WTF: Very, Very Well Documented
by in Feature Articles on 2022-07-04It's Independence Day in the US, but today, let's instead celebrate our dependence on good quality documentation. It matters. Even when we measure the size of that documentation in meters, instead of freedom units. Original -- Remy
Just about all of the systems I’ve written about here share quite a few things in common: they are poorly designed, poorly coded, and even more poorly documented. Today, I’m happy to share with you a system that doesn’t quite fit in with all the rest. It’s actually very sound software and, most of all, it’s well documented. Very, very well documented.
George Nacht is a software engineer in certain a Post-Communist European country. In the mid-1990’s, his government decided that it was time to replace their foreign, Soviet-era fighter jets with modern, less expensive aircrafts of domestic design. And since they were modernizing their fleet, they decided to modernize their pilot training as well. This meant that new, interactive flight-simulator software needed to be developed.