add methods documentation, add default values for parameters