better docs/works with errors/messages