Problem
The template publishes Docker images but has no task for pushing the Docker Hub repository overview (the README shown on the Docker Hub page). Docker downstreams each add their own:
ptr727/NxWitness ships publish-docker-readme-task.yml (matrix over its images, static Docker/README.md, peter-evans/dockerhub-description, DOCKER_HUB_ACCESS_TOKEN), called from publish-release.yml.
ptr727/ESPHome-NonRoot now mirrors it (single repo, static Docker/README.md), wired into publish-release.yml like the date-badge job. This replaced an older bespoke m4 + toolversions README generator that also relied on a separate, undocumented DOCKER_HUB_PASSWORD secret.
Suggestion
Ship a reusable publish-docker-readme-task.yml skeleton in the template (single-repo by default, documented matrix variant for multi-image repos) and call it from publish-release.yml for Docker-shipping repos. Standardizing on DOCKER_HUB_ACCESS_TOKEN (not a separate password secret) would also remove the secret-naming drift each Docker downstream currently has to rediscover.
Surfaced while adopting the template in ptr727/ESPHome-NonRoot (see ptr727/ESPHome-NonRoot#61).
Problem
The template publishes Docker images but has no task for pushing the Docker Hub repository overview (the README shown on the Docker Hub page). Docker downstreams each add their own:
ptr727/NxWitnessshipspublish-docker-readme-task.yml(matrix over its images, staticDocker/README.md,peter-evans/dockerhub-description,DOCKER_HUB_ACCESS_TOKEN), called frompublish-release.yml.ptr727/ESPHome-NonRootnow mirrors it (single repo, staticDocker/README.md), wired intopublish-release.ymllike thedate-badgejob. This replaced an older bespoke m4 +toolversionsREADME generator that also relied on a separate, undocumentedDOCKER_HUB_PASSWORDsecret.Suggestion
Ship a reusable
publish-docker-readme-task.ymlskeleton in the template (single-repo by default, documented matrix variant for multi-image repos) and call it frompublish-release.ymlfor Docker-shipping repos. Standardizing onDOCKER_HUB_ACCESS_TOKEN(not a separate password secret) would also remove the secret-naming drift each Docker downstream currently has to rediscover.Surfaced while adopting the template in
ptr727/ESPHome-NonRoot(see ptr727/ESPHome-NonRoot#61).