updating the markdown so it's easier to read.