add a section about performance and fix a few description