Update README to assume a less introduced reader

[consideRatio]

I tried to answer some of my own questions by inspecting the code, and updated the readme and added some inline comments to reflect what I learned.

The readme is tweaked a bit based on what I found to improve readability, and i included in this PR some post-migration fixes where the old location of the github repo was still referenced.

[manics]

This look like a good time to mention there's a workflow bot that tries to keep dist/ up to date when src changes:

action-major-minor-tag-calculator/.github/workflows/test-and-update.yml

Lines 18 to 23 in b1f8ea0

	- uses: stefanzweifel/git-auto-commit-action@be7095c202abcf573b09f20541e0ee2f6a3a9d9b
	with:
	commit_message: "[update-dist-bot] auto-format and update dist"
	commit_user_name: update-dist-bot
	commit_user_email: update-dist-bot@example.org
	commit_author: "update-dist-bot <update-dist-bot@example.org>"

At the moment it uses the default GITHUB_TOKEN which means the CI test won't be re-run after the commit is pushed, so in general you'll need to close and reopen the PR to refresh the tests. Alternative would be to use an access token. https://docs.github.com/en/actions/reference/events-that-trigger-workflows#triggering-new-workflows-using-a-personal-access-token

[consideRatio]

Ahhhh that makes sense, thanks for explaining the reason for the tests to not re-trigger. I understand it is a way to protect against infinite triggering of GitHub workflows.

[manics]

A few optional suggestions

[manics]

Cheers