add README with explanations

Also, improve a code comment