From b0c8aa8fec5178599b405b65ea1ee3a1d38ec9b4 Mon Sep 17 00:00:00 2001
From: Simon McVittie <smcv@collabora.com>
Date: Fri, 22 Nov 2024 15:17:09 +0000
Subject: [PATCH] slr-for-game-developers: Expand on why SONAMEs are the name
 to use

Signed-off-by: Simon McVittie <smcv@collabora.com>
---
 docs/slr-for-game-developers.md | 10 +++++++---
 1 file changed, 7 insertions(+), 3 deletions(-)

diff --git a/docs/slr-for-game-developers.md b/docs/slr-for-game-developers.md
index c27c992d0..f5a8bc52c 100644
--- a/docs/slr-for-game-developers.md
+++ b/docs/slr-for-game-developers.md
@@ -1251,9 +1251,13 @@ so it should not be necessary to build your own version of SDL.
 
 If you load a library dynamically, make sure to use its versioned SONAME,
 such as `libvulkan.so.1` or `libgtk-3.so.0`, as the name to search for.
-Don't use the development symlink such as `libvulkan.so` or `libgtk-3.so`,
-and also don't use the fully-versioned name such as `libvulkan.so.1.2.189`
-or `libgtk-3.so.0.2404.26`.
+Avoid using the development symlink such as `libvulkan.so` or `libgtk-3.so`,
+which will not be available in the Steam Linux Runtime container,
+and does not guarantee ABI compatibility even if it works.
+Also avoid using the fully-versioned name such as `libvulkan.so.1.2.189`
+or `libgtk-3.so.0.2404.26`,
+because that name will no longer work if the library is upgraded to a
+newer compatible version.
 
 Use the versions of libraries that are included in the Steam Runtime,
 if possible.
-- 
GitLab