DOC : fixed typos in known_fail_if doc

 - fixed typos in docstring
 - added a few more comments
 - removed misleading comments