While these comments are great, I think we should format and indent them so that we can get more words in per line. Otherwise this gets really long to scroll through and harder to read. Perhaps:

@param potentialPct   The percent of the blah blah blah
             blah blah blah blah blah blah blah blah blah blah
             blah blah blah blah blah blah blah blah blah blah
             blah blah blah blah blah blah blah blah blah blah