optimizations and readme additions