small fixes to md documentation