switching to .md ext for github, also fixing some random errors in markdown