docker-library / docker-library/docs
Latest version placeholder
Nobody has claimed this yet.
- Dominant language
- Shell
- Stars
- 5.3k
- Forks
- 2.2k
- Avg merge
- 1d 18h
- Merged PRs (30d)
- 11
Description
I originally asked about this here https://github.com/docker-library/docs/pull/1802#discussion_r497240482 but I didn't get an answer, so I figured I'd open an issue instead to discuss it.
Is there any way to dynamically replace this
<version>with a placeholder? I dug through the scripts in this repo and I didn't find any relevant placeholders.Ideally, I'd like a
%%LATEST_VERSION%%placeholder that would basically be the version number that thelatesttag shares.I've already gotten a question from a user recently who is new to Docker asking "do I need to replace
<version>?" so I think this should be improved.
I realize that this is probably non-trivial because the latest tag doesn't directly map to a specific version because of how tagging works. Maybe there's a way to hook into the docs generator to provide additional placeholders? We could write a simple script that extracts the relevant info based on some heuristic.
Contributor guide
No contributing guide indexed for this repository
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
Start by reviewing the discussion in docker-library/docs#1802 and the repository scripts referenced in the issue. Trace how the docs generator handles placeholders and how the latest tag is represented. Done means the project has a decided, documented approach for exposing the latest version, with the behavior verified in the generator workflow.
Written by the indexing model from the issue text.
Assessment
- Tech stack
- docker
- Domain
- documentation, tooling
- Issue type
- Feature
- Difficulty
- 5/5
- Estimated time
- Over a week
- Activity status
- Stale
- Clarity
- Needs clarification
- Newbie friendliness
- 25/100