Interfaces are the faces of your company. Companies hire UX designers to make their websites easy to use, consistent, intuitive, and clean. These same companies often don't care about their API design; apparently "it works" is all they aspire to. However, your API is an interface; another face for your company. If it's hard to use, inconsistent, non-intuitive, or ugly, annoying a developer could be the best case scenario; you might lose customers.

Here are 20 tips from a former developer turned technical writer who thinks that it's better to design a good API rather than simply document a bad API.