Fix docs to match new behaviour and use case suggested in #12