Describe that an API documentation might be out of date and how to recover

as suggested by Martijn Faassen.