use markdown formatting, minor updates