optimization notes
merged README versions