fix docblocks on the user provider interface