issue #20, fix documentation (#23)

Author: thirtytwobits

README.md

@@ -10,9 +10,8 @@ containers to get consistent build results in your local development environment
 
 To allow hosting of multiple container builds from a single repo each toolchain container
 is assigned a prefix. For every release event in this repo the workflow triggered is based
-on that prefix in the release tag. For example, by creating a release with the tag `tsv18.4.1-alpha`
-the release workflow for the `toolshed` container will be triggered (note that the 'v' in 'tsv' will be
-elided by the release action).
+on that prefix in the release tag. For example, by creating a release with the tag `ts18.4.1-alpha`
+the release workflow for the `toolshed` container will be triggered.
 
 ### opencyphal/toolshed:ts
 
@@ -82,3 +81,9 @@ jobs:
     runs-on: ubuntu-latest
     container: ghcr.io/opencyphal/toxic:tx20.4.1
 ```
+
+---------------------------
+
+Note that, if you create a new container in this project, the prefix cannot end with 'v'. So "tu22.4.1" is okay but
+"tv28.3.1" won't work because the release workflows elide "v" (as in version) by default and the container will become
+"t28.3.1" in packages but "tv.28.3.1" as a git tag.

texer/README.md

@@ -7,8 +7,8 @@ and publication of OpenCyphal [LaTeX](https://www.latex-project.org/) documents.
 
 To release a new build of this container simply create a [new github release](https://github.com/OpenCyphal/docker_toolchains/releases/new)
 that starts with `te`, uses the Ubuntu major and minor version, and uses an monotonically increasing "patch" version.
-For example `tev20.4.1`will cause the Github workflow to rebuild and push the `opencyphal/texer` container with the
-tag `te20.4.1` (where the release workflow elides the 'v').
+For example `te20.4.1`will cause the Github workflow to rebuild and push the `opencyphal/texer` container with the
+tag `te20.4.1`.
 
 ***PLEASE UPDATE THE TOP-LEVEL README.md FOR EACH NEW RELEASE***
 

toolshed/README.md

@@ -7,8 +7,8 @@ for development, continuous-integration, and test automation of C and C++ based
 
 To release a new build of this container simply create a [new github release](https://github.com/OpenCyphal/docker_toolchains/releases/new)
 that starts with `ts`, uses the Ubuntu major and minor version, and uses an monotonically increasing "patch" version.
-For example `tsv20.4.1`will cause the Github workflow to rebuild and push the `opencyphal/toolshed` container with the
-tag `ts20.4.1` (where the release workflow elides the 'v').
+For example `ts20.4.1`will cause the Github workflow to rebuild and push the `opencyphal/toolshed` container with the
+tag `ts20.4.1`.
 
 ***PLEASE UPDATE THE TOP-LEVEL README.md FOR EACH NEW RELEASE***
 

toxic/README.md

@@ -7,8 +7,8 @@ for development, continuous-integration, and test automation of Python based pro
 
 To release a new build of this container simply create a [new github release](https://github.com/OpenCyphal/docker_toolchains/releases/new)
 that starts with `tx`, uses the Ubuntu major and minor version, and uses an monotonically increasing "patch" version.
-For example `txv20.4.1`will cause the Github workflow to rebuild and push the `opencyphal/toxic` container with the
-tag `tx20.4.1` (where the release workflow elides the 'v').
+For example `tx20.4.1`will cause the Github workflow to rebuild and push the `opencyphal/toxic` container with the
+tag `tx20.4.1`.
 
 ***PLEASE UPDATE THE TOP-LEVEL README.md FOR EACH NEW RELEASE***