added file documenting performance improvements -- not finished