add README with detailed comments and script output