added comments

rewrote match rating class functions for clarity