Merge README files into README.md and tweak code comments