beeware · freakboy3742 · Dec 4, 2023 · Dec 3, 2023 · Dec 4, 2023 · Dec 4, 2023
diff --git a/changes/2255.doc.rst b/changes/2255.doc.rst
@@ -0,0 +1 @@
+Some limitations on App presentation imposed by Wayland have been documented.
diff --git a/docs/reference/api/app.rst b/docs/reference/api/app.rst
@@ -70,6 +70,16 @@ details, along with many of the other constructor arguments, as packaging metada
 format compatible with :any:`importlib.metadata`. If you deploy your app with `Briefcase
 <https://briefcase.readthedocs.io/en/stable>`__, this will be done automatically.
 
+Notes
+-----
+
+* Apps executed under Wayland on Linux environment may not show the app's formal name
+  correctly. Wayland considers many aspects of app operation to be the domain of the
+  windowing environment, not the app; as a result, some API requests will be ignored
+  under a Wayland environment. Correctly displaying the app's formal name requires the
+  use of a desktop metadata that Wayland can read. Packaging your app with `Briefcase
+  <https://briefcase.readthedocs.io/en/stable>`__ is one way to produce this metadata.
+
 Reference
 ---------
 

diff --git a/docs/spelling_wordlist b/docs/spelling_wordlist
@@ -85,6 +85,7 @@ Ventura
 verbing
 viewport
 watchOS
+Wayland
 WebKit
 whitespace
 Winforms