We see more and more that we do our best to do documentation but that font is causing really weird situations.

Things like a simple word like classes can look like dasses if you read it with the current selected font. I would suggest using a True Type font for the md file that available on most systems and OSes. At this moment it can be very confusing if someone makes good documentations.