notes on optimizing added to doc