documentation changes for clarity