some readme copy; also fixing up github markdown formatting