improving documentation, reducing parameters