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.
that's a typo, it's with 'i' in the code