docker - Dockerhub Repository Description -

does know how dockerhub manages description on automatic build repositories?

dockerhub has nice feature readme.md source repository taken repository description. in practise description of repository not latest readme.md master branch. appears quite random or related latest builds.

example repository:

• /
• dockerfile
• readme.md

branches:

• master

tags:

• v1.0
• v1.1
• v2.0
• v2.1

now problem: if put tags on autobuild not reproducable readme.md shown in repositories description.

is there trick or there api can can set description?

my wish latest commit of master/readme.md displayed!

the dockerhub doc mentions:

the build process looks readme.md in same directory dockerfile.

(see instance tombatossals/dockerhub/nodejs)

if have readme.md file in repository, used in repository full description.

if change full description after build, overwritten next time automated build runs.
make changes, modify readme.md in git repository.

note, mentioned here andy, not work manual build.

for manual builds (where push own image), docker hub not peek inside image , has no way know readme.
you'll need manually add readme text information section.

---

the op asks:

is there api call can set description of repo?

not know of (docker hub api deprecated in docker 1.8+)

---

issue 467 reports same uncertainty:

sometimes automated build system still use top-level readme file.

and issue 402 reports:

"every once in while, content in full description , dockerfile page old release tag."

and then:

"has specification pulling readmes changed? takes top-level readme source repository instead of directory dockerfile specified; considering common use-case repository of dockerfiles has messed documentation."

issue 300 confirms:

i notice 2 obvious failings here:

• a) readme.md not respected in sub-directory dockerfile
• b) if readme.md @ repoository's top-level (as dockerfile) "sometimes" not read in , description left blank; after force pushes underlying repository.