O Problema é quando a documentação é feita de qualquer jeito, normalmente isso não acontece, mas já vi pouquissimos casos, por exemplo a do Mercado Pago , que desmotiva muito para continuar, quase troquei a API do projeto por conta disso.