Documentation as Code

The older I get the more I have come to despise Microsoft Word for technical documentation. In my world, documentation requires constant updates and periodic review and revision and when things go bad in Word which invariably happens, it goes really bad. Throw in multiple editors and multiple revisions over time and you usually end up with something that starts to lose its formatting over time and when your heading structure and auto-numbering breaks, well then all bets are off and sometimes your better off to spend the time and rewrite it.

Continue reading