Small documentation fixes.
Moved introductory explanations from code to README.