When people want to learn a new skill, then knowing the gotchas (common and not-so-common mistakes) is extremely helpful.
This is kinda like ending up on StackExchange ... but even before you run into the issue ^_^.
An API allows other sites to embed relevant gotchas dynamically (syndication).