minimal updates in methods documentation