markdown mostly

The github editor and my text editor don't get along well, so you'll want to select individual fixes.  

Plus there are a few questions embedded.