improved parameter naming
updated README