I am trying to learn how to publish a python package onto PyPI and I'm a little stuck with setting up a github action to publish a release, specifically with the code that runs when I push with a tag.

I am trying to follow the semantic versioning practice (as recommended), so my pyproject.toml file has the initial version set to version = "0.1.0". (I didn't set it up before but that's fine - I'd like my next version to be 0.1.1 after some additional changes). I expect to manually change it, create a tag, and push that to my main branch for the action to run.

In the documentation example, I see that the action yaml file contains the line uses: pypa/gh-action-pypi-publish@release/v1. I have never done this before and almost went with that, but I am not sure why the example shows v1 hardcoded, so I don't think I actually want this to happen. It doesn't seem to be well explained though, and the pypi-publish action repo was also quiet on this. Is this saying that it will create a release branch in my repo and call the release v1? Or how will this appear after I've done it? Will I have to manually change this v1 to v0.1.1 in the actions file AND the pyproject.toml?

I saw a video giving a demo, but the uses command in that was outdated (it showed master branch) and it seemed clearer, so I don't really know what to do about it.