documentation changes for both functions