Views: 4265 (Data available since 06.02.2017)
As a rule, API is written some time (usually two or three months) after release. Unfortunately, it also occurs that the old functionality is not described fully and correctly. For example, changes were made but not included in the documentation.
Thus, the only solution for the developer consists in reviewing the code itself.