Update README

Longer description and note about directory structure (to avoid surprises when someone tries to run this code).