It's vague because it's a problem in many areas. It could be a documentation issue. It could be data returned. It could be naming conventions/parameters. I don't like being surprised by a result coming from an API.