updated docs for clarity's sake