some readme copy; also fixing up github markdown formatting
merging in changes from engine master