[docs] readme
[matcher] remove unnecessary method from candidate interface
[style] cleanup comment dividers "// --" because their hard to maintain