docs; resize; clarify the arguments