minor markdown and comment modifications