A Documentation Cautionary Tale.

Heroku, a platform as a service (PAAS) cloud service provider, was caught with documentation that described software that subscribers weren't getting.

In this documentation bait-and-switch, Heroku's documented a technology that they'd removed from their product because it didn't scale with their increasing customer base.

Eventually, they had to admit that their documentation was about 2 years out of date, which they chalked up to "focus on new products". They burned their own clients, and their potential future clients, by showing themselves to be untrustworthy.

There is a warning there: documentation is a type of advertising. It had better describe what customers are paying for!