cleanup scoring logic a little
API Doku in README