chore: more docs things ig

discord/ui/file.py

@@ -56,8 +56,7 @@ class File(Item[V]):
 
         class MyView(ui.LayoutView):
             file = ui.File('attachment://file.txt')
-            # attachment://file.txt points to an attachment uploaded alongside
-            # this view
+            # attachment://file.txt points to an attachment uploaded alongside this view
 
     Parameters
     ----------

discord/ui/media_gallery.py

@@ -45,7 +45,9 @@ __all__ = ('MediaGallery',)
 class MediaGallery(Item[V]):
     """Represents a UI media gallery.
 
-    This can contain up to 10 :class:`.MediaGalleryItem` s.
+    Can contain up to 10 :class:`.MediaGalleryItem` 's.
+
+    This is a top-level layout component that can only be used on :class:`LayoutView`.
 
     .. versionadded:: 2.6
 

discord/ui/section.py

@@ -44,6 +44,8 @@ __all__ = ('Section',)
 class Section(Item[V]):
     """Represents a UI section.
 
+    This is a top-level layout component that can only be used on :class:`LayoutView`
+
     .. versionadded:: 2.6
 
     Parameters

discord/ui/separator.py

@@ -42,6 +42,8 @@ __all__ = ('Separator',)
 class Separator(Item[V]):
     """Represents a UI separator.
 
+    This is a top-level layout component that can only be used on :class:`LayoutView`.
+
     .. versionadded:: 2.6
 
     Parameters

discord/ui/text_display.py

@@ -42,6 +42,8 @@ __all__ = ('TextDisplay',)
 class TextDisplay(Item[V]):
     """Represents a UI text display.
 
+    This is a top-level layout component that can only be used on :class:`LayoutView`.
+
     .. versionadded:: 2.6
 
     Parameters