callback is not optional for `close()`
complete documentation of current API

also include notes about the API change process