large comment explaining the threshold default and some formatting fixes