manual/animation/armatures/posing/editing/pose_library.rst

@@ -253,12 +253,15 @@ Use from 3D Viewport
 
 .. figure:: /images/asset_browser-pose_library-use_from_viewport.png
 
-   The pose library as a side-panel of the 3D Viewport.
+   The pose library in use from the Asset Shelf.
 
-The Sidebar of the 3D Viewport has a Pose Library panel in the Animations tab.
-Contrary to the Asset Browser, which can be used for different asset types and
-also for some asset management tasks, this panel is dedicated to applying poses.
-This means that it can allow faster interaction.
+.. note::
+
+  The pose library previously lived in the Sidebar within the Pose Library panel.
+  The panel still exists, but now contains a button to open the asset shelf.
+
+In the 3D viewport, poses can be quickly applied from the Asset Shelf. 
+Contrary to the Asset Browser, the shelf allows you to apply poses quicker.
 
 **Click on a pose to apply it.** A single click is enough.
 You can also select and apply a pose via the cursor keys.
@@ -268,10 +271,7 @@ to directly see the result on the active character.
 **Drag the pose thumbnail left to right to blend it** into the character's current pose.
 Just release the mouse button to confirm.
 
-To **search for poses**, hover your mouse over the poses,
-then press :kbd:`Ctrl-F` and type a search query.
-This will filter the poses to match what you typed.
-The scrollable area will automatically scroll the search field into view.
+For additional features of the Asset Shelf refer to its :doc:`documentation </editors/asset_shelf>`.
 
 
 .. _pose-library-old:

manual/editors/asset_shelf.rst

@@ -0,0 +1,36 @@
+
+***********
+Asset Shelf
+***********
+
+Search
+======
+
+To search for assets, hover your mouse over the Asset Shelf, then press Ctrl-F and type a search query. 
+This will filter the poses to match what you typed.
+
+
+Tabs
+====
+
+.. figure:: /images/asset_shelf-tabs.png
+
+   The usage of catalogs as tabs.
+
+Catalogs can be shown as individual tabs. Each tab will only show its content, and the content of its children. 
+That makes it easy to filter down to a certain set of assets.
+
+
+Display Options
+===============
+
+.. figure:: /images/asset_shelf-options.png
+
+   Display options available for the asset shelf.
+
+It is possible to change the size of items on the shelf by using the size property.
+
+By toggling on the "Names" checkbox, the asset names will be shown in the shelf. Alternatively it is also
+possible to hover over an item to show its name.
+
+By default the shelf only has a height for one item row. To allow for more rows, drag it on the upper edge to increase its size.

manual/editors/index.rst

@@ -70,5 +70,6 @@ See :doc:`User Interface </interface/index>` for documentation on the general in
    properties_editor.rst
    file_browser.rst
    asset_browser.rst
+   asset_shelf.rst
    spreadsheet.rst
    preferences/index.rst