docker / docker/metadata-action
Better document implicit defaults of `labels`/`annotations`
Nobody has claimed this yet.
- Dominant language
- TypeScript
- Stars
- 1.1k
- Forks
- 160
- Avg merge
- 4d 17h
- Merged PRs (30d)
- 12
Description
Description
The relevant source is reasonably straight-forward to interpret and unlikely to change:
NOTE: Presently some of those defaults cannot be easily expressed explicitly (sometimes preferable as visibility for maintainers vs implicit knowledge), but this would be much simpler to document if the following was resolved:
- https://github.com/docker/metadata-action/issues/584
- https://github.com/docker/metadata-action/issues/585
- https://github.com/docker/metadata-action/issues/591
org.opencontainers.image.version in particular has been a common caveat users have tripped up on. More relevant direct documentation on this default could link to the priority attributes section for improved visibility/discovery and thus awareness (instead of encountering it after tags are published). See the last section of my next comment for more info.
Contributor guide
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
Research direction
Read src/meta.ts at lines 540-550 to confirm the implicit defaults for labels and annotations, then review issues 584, 585, and 591 because they may affect how the defaults can be documented. Update the relevant documentation to make the defaults, especially org.opencontainers.image.version, more visible and link to the priority attributes section.
Written by the indexing model from the issue text.
Assessment
- Tech stack
- docker, github-actions, typescript
- Domain
- devops, documentation
- Issue type
- Documentation
- Difficulty
- 2/5
- Estimated time
- 1-3 hours
- Activity status
- Stale
- Clarity
- Mostly clear
- Newbie friendliness
- 45/100