clarifying, commenting
adding scoring function, clarifying parameter input names