Update the README with more (up-to-date) instructions + minor update to code comments
This MR updates the project README with proper instructions on how to use the code provided in this project and how to develop this code further.
It also contains minor improvements to comments in the CI/CD code.