Trying to use library X, but can't figure out how, until I stumble on the README for another library Y (which does something similar to library X): In Y's README, there's a section titled "Motivation", which starts with:
"What's wrong with library X? In X, you'd do something like:
<example code that perfectly demonstrates how to use X>
which suffers from such and such issues"