Writing good documentation is assisted by writing good code in the first place. The better the code, the less work it should take to document it. User martianE points out the different role ...

You promise yourself you’ll “clean up the docs later.” Then a new hire Slacks you at 10:47 p.m. asking how deployments work.

Unlock the full InfoQ experience by logging in! Stay updated with your favorite authors and topics, engage with content, and download exclusive resources. In this episode, Thomas Betts chats with ...

As an IT professional, you’ve probably spent countless hours staring at a blank document, trying to craft the perfect software documentation. We’ve all been there and the project is demanding much of ...

Unlock the full InfoQ experience by logging in! Stay updated with your favorite authors and topics, engage with content, and download exclusive resources. In this episode, Thomas Betts chats with ...

Community driven content discussing all aspects of software development from DevOps to design patterns. In Ye Olden Days, I was a COBOL programmer, working on a Unisys E1100 system with a CODASYL ...

Andy Oram posted his survey write-up on why people contribute documentation. Pretty interesting, but still a bit hard to quantify (says Andy himself.) I tend to think that people who write ...

The Sarbanes-Oxley Act has brought both opportunities and challenges. CPAs engaged to write documentation enter a new world of narratives, control assessments, testing and remediation plans—but ...