APIs enable developers to define the interactions between software and services. But simply creating an API isn't enough. Documentation makes the difference between happy and frustrated API adopters.

What is documentation? Why is it important? What makes it good or bad? And – if it’s bad – what are the consequences? In this article, I’ll discuss all of this, explain how documentation (good or bad) ...

Companies that produce software invariably face the question of how to publish its documentation. No easy answers exist. Many software documentation tools are available, but there is no clear leader.

Picture this: You’ve just bought a fancy new gadget and feel pretty good about your decision. But when you try to set it up, disaster strikes. The buttons don’t do what they should. The settings menu ...