update documentation: performance issues