Changed documentation following discussions with @kimchy and @simonw on handling API changes