karma: add comments describing how penalty settings are used