documentation for the parameters and use well named variables instead A and B