more readable and consistent description of parameters