Update PORTAINER_STACK.md to reflect git tag prefix change #142

New Issue

Polly · 2026-07-08T20:12:37Z

Polly commented

2026-07-08 20:12:37 +00:00

Description

When I review the Portainer stack documentation, I want it to accurately reflect the current git tag naming convention, so I can avoid confusion when deploying or referencing release images.

Background

PR #141 removed the pa- prefix from git tags. Previously, tags followed the pattern pa-0.x.x (e.g., pa-0.26.0). After the change, tags are now plain semver (e.g., 0.26.0). The file PORTAINER_STACK.md (or equivalent documentation) must be updated to reflect this change.

Acceptance Criteria

GIVEN a reader looks at PORTAINER_STACK.md WHEN they check the image tag format THEN it shows the new plain semver convention (e.g., 0.x.y) instead of pa-0.x.y
GIVEN the file is missing entirely WHEN the issue is addressed THEN a new PORTAINER_STACK.md is created with accurate tag documentation
GIVEN any references to the old pa- prefix exist in the repo's Portainer stack documentation WHEN the update is complete THEN all such references are removed

Technical Notes

The affected workflow is .gitea/workflows/portainer_automation_build_push.yml (updated in PR #141)
Image tags are now: 0.x.y for test builds, 0.x.0 for prod, plus test and prod floating tags
The PORTAINER_STACK.md file lives under the portainer-automation/ directory or may need to be created there
See also: PR #141 and milestone #5

Dependencies

Related to: #141

Story Points: 1

Priority: low

## Description When I review the Portainer stack documentation, I want it to accurately reflect the current git tag naming convention, so I can avoid confusion when deploying or referencing release images. ## Background PR #141 removed the `pa-` prefix from git tags. Previously, tags followed the pattern `pa-0.x.x` (e.g., `pa-0.26.0`). After the change, tags are now plain semver (e.g., `0.26.0`). The file `PORTAINER_STACK.md` (or equivalent documentation) must be updated to reflect this change. ## Acceptance Criteria - GIVEN a reader looks at PORTAINER_STACK.md WHEN they check the image tag format THEN it shows the new plain semver convention (e.g., `0.x.y`) instead of `pa-0.x.y` - GIVEN the file is missing entirely WHEN the issue is addressed THEN a new `PORTAINER_STACK.md` is created with accurate tag documentation - GIVEN any references to the old `pa-` prefix exist in the repo's Portainer stack documentation WHEN the update is complete THEN all such references are removed ## Technical Notes - The affected workflow is `.gitea/workflows/portainer_automation_build_push.yml` (updated in PR #141) - Image tags are now: `0.x.y` for test builds, `0.x.0` for prod, plus `test` and `prod` floating tags - The `PORTAINER_STACK.md` file lives under the `portainer-automation/` directory or may need to be created there - See also: PR #141 and milestone #5 ## Dependencies - Related to: #141 ## Story Points: 1 ## Priority: low