improve the html description
parameterize the scoring function