added some documentation to threshold_proportional