From 4eb4f9296cf204206dc19706818bd87d8385d468 Mon Sep 17 00:00:00 2001 From: TechnicJelle <22576047+TechnicJelle@users.noreply.github.com> Date: Sat, 9 May 2026 03:33:29 +0200 Subject: [PATCH 1/2] Made it clearer that you really should use exact pinned tags with Docker --- wiki/getting-started/Installation.md | 16 ++++++++++++---- 1 file changed, 12 insertions(+), 4 deletions(-) diff --git a/wiki/getting-started/Installation.md b/wiki/getting-started/Installation.md index 465f1fd..55d14e2 100644 --- a/wiki/getting-started/Installation.md +++ b/wiki/getting-started/Installation.md @@ -114,11 +114,19 @@ This is useful if you want to render a map of a minecraft-world, but don't want ## Using BlueMap Docker image You can use [BlueMap CLI](#using-bluemap-on-the-cli--standalone) in a Docker container. This is perfect for container loving sysadmins. + The image is available on GitHub container registry as `ghcr.io/bluemap-minecraft/bluemap`. -For latest and greatest the `latest` tag is the latest release (which can be a pre-release) and `master` the latest git commit. -You can also choose a latest minor of a major with tags such as `v5` or a specific version tag such as `v5.13`. -For production usage you should **always** pin the version to the minor version as even the latest minor might still be a pre-release. -You can see the list of available Docker tags on [GitHub](https://github.com/BlueMap-Minecraft/BlueMap/pkgs/container/bluemap). + +For production usage you should **always** pin the version to a specific version (such as `v5.20`) as even the latest minor might still be a pre-release. +This is because some updates (even minor ones) require manual upgrades, which will always be listed in the changelog. + +The list of available Docker tags is available on [GitHub](https://github.com/BlueMap-Minecraft/BlueMap/pkgs/container/bluemap). + +You can subscribe to be notified of new releases through [GitHub's "watch repository" feature](https://github.com/BlueMap-Minecraft/BlueMap) or the [Discord server](https://bluecolo.red/map-discord), so you can know when to bump up your pinned version. + +If you accept instability, you can use the `latest` tag, which is the latest release (which can be a pre-release) or `master` for the latest git commit. +You can also choose a latest minor of a major with tags such as `v5`. + The documentation will from now on substitute the version with ``. ### Prerequisites From 5f4050067370cd3835f3dbec3497ff041a324dae Mon Sep 17 00:00:00 2001 From: TechnicJelle <22576047+TechnicJelle@users.noreply.github.com> Date: Sat, 9 May 2026 03:43:36 +0200 Subject: [PATCH 2/2] Whether it still happens or not, we won't mention the possibility and simply use the other thing as the only reason --- wiki/getting-started/Installation.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/wiki/getting-started/Installation.md b/wiki/getting-started/Installation.md index 55d14e2..f469e0f 100644 --- a/wiki/getting-started/Installation.md +++ b/wiki/getting-started/Installation.md @@ -117,8 +117,8 @@ You can use [BlueMap CLI](#using-bluemap-on-the-cli--standalone) in a Docker con The image is available on GitHub container registry as `ghcr.io/bluemap-minecraft/bluemap`. -For production usage you should **always** pin the version to a specific version (such as `v5.20`) as even the latest minor might still be a pre-release. -This is because some updates (even minor ones) require manual upgrades, which will always be listed in the changelog. +For production usage you should **always** pin the version to a specific version (such as `v5.20`), +because some updates (even minor ones) require manual upgrades, which will always be listed in the changelog. The list of available Docker tags is available on [GitHub](https://github.com/BlueMap-Minecraft/BlueMap/pkgs/container/bluemap).