Docs improvements in README.md

[spier]

Documentation fixes in the main README.md.

Proposed Changes

• Some rewording in the first sentence, highlighting that the output of the GHA is a GitHub issue.
• minor bug fix (double space)
• minor cosmetics fixes in the markdown (not visible for the general readers, just for people reading the markdown)
• I am also leaving one question as a comment in this PR, about an area where I am not sure how the * footnotes are supposed to be formatted

Readiness Checklist

Author/Contributor

• If documentation is needed for this change, has that been included in this pull request
• run make lint and fix any issues that you have introduced
• run make test and ensure you have test coverage for the lines you are introducing
• Label as either bug, documentation, enhancement, infrastructure, or breaking

[spier]

I cannot add a label, as requested in the instructions.

[spier]

In order to make lint as the instructions request, I had to pip3 install flake8 pylint.

Not sure if those two dependencies are missing from requirements.txt?
(maybe not, if they are only required when developing/testing?)

[zkoppert]

I cannot add a label, as requested in the instructions.

Thanks for catching this!
Fix this here: 3dd3d58

[zkoppert]

In order to make lint as the instructions request, I had to pip3 install flake8 pylint.

Not sure if those two dependencies are missing from requirements.txt? (maybe not, if they are only required when developing/testing?)

I've got a pull request open to fix this. Another great find. Thanks for bringing it to my attention @spier!

[zkoppert]

🎉 Thanks for the fixes and improvements!! Really appreciate you taking the time to upstream these and help the next user that has to read these docs!