postgres icon indicating copy to clipboard operation
postgres copied to clipboard

Link 'current' documentation page

Open EugenKon opened this issue 1 year ago • 2 comments

On the page:https://hub.docker.com/_/postgres in how to extend this image section:

Note 2: This variable defines the superuser password in the PostgreSQL instance, as set by the initdb script during initial container startup. It has no effect on the PGPASSWORD environment variable that may be used by the psql client at runtime, as described at https://www.postgresql.org/docs/14/libpq-envars.html. PGPASSWORD, if used, will be specified as a separate environment variable.

link to 14 postgres version is used. To my mind it would be better to use link to 'current' version https://www.postgresql.org/docs/current/libpq-envars.html

EugenKon avatar Oct 05 '23 16:10 EugenKon

We avoid linking to "current" because as you can see, we're not the best at keeping up with updating URLs like this in our documentation, so when the upstream documentation reorganizes, our links break in ways that are harder to fix than if we have a link to something that was right and still works (and already links to newer versions of itself up at the top of the page).

tianon avatar Dec 07 '23 20:12 tianon

To put that another way, I'd be in favor of a PR that updates https://github.com/docker-library/docs/blob/master/postgres/content.md?plain=1 to point to /16/, but not to one that updates to /current/.

tianon avatar Dec 07 '23 20:12 tianon