Performance & examples

Added a description about performance, created one for performance and
did some other edits in the readme file.