update readme; improved formatting; context