add notes about performance improvements