Page MenuHomePhabricator

Discovery of the Wikibase-Containers ENV vars is hard
Closed, DuplicatePublic

Description

People don't find it obvious where to know what user ENVs are possible to set.

Currently they are buried in the READMEs but people didn't instantly know to look there.

Even someone who forked the repo and edit his own docker files didn't know they were documented until today. He didn't ever visit docker hub.

Event Timeline

I wouldn't really call them buried in the readme, they take up around 1/4 of the readme, https://github.com/wmde/wikibase-docker/blob/master/wikibase/README.md#environment-variables
The readme for the docker image follows a pretty standard practice for how the documentation of the env vars is done.

He didn't ever visit docker hub.

This is in theory how people discover the docker files.
If you're looking for a docker file you go there, you dont randomly dig through github.