manual/editors/outliner/interface.rst

@@ -20,6 +20,9 @@ It helps to narrow the list of objects so that you can find things quickly and e
    Shows all the collections and objects in the current view layer.
 :Video Sequencer:
    Lists data, images and videos, that are used by the :doc:`Video Sequencer </video_editing/index>`.
+
+.. _outliner-blender-file-mode:
+
 :Blender File:
    Lists all data in the current blend-file.
 :Data API:

manual/files/asset_libraries/introduction.rst

@@ -100,6 +100,8 @@ When the current blend-file is part of an asset library, you can also see its as
 The assets that are in the current file are marked with an icon; only those are editable.
 
 
+.. _asset-life-cycle:
+
 Life Cycle of an Asset
 ======================
 

manual/sculpt_paint/brush/brush_management.rst

@@ -5,12 +5,13 @@ Manage Brushes
 Brush assets are stored in :doc:`asset libraries </files/asset_libraries/introduction>` to make them accessible from
 any Blender session. There are two ways of managing brush assets:
 
-- :ref:`Asset Operators <brush-management-utility-operators>`: Create and update brush assets using utility operators
-  from any Blender file. Storage is managed by Blender. Convenient for simple "on the fly" management of personal brush
+- Using :ref:`asset operators <brush-management-utility-operators>`: Create and update brush assets
+  using utility operators from any Blender file. Storage is managed by Blender. Convenient for
+  simple "on the fly" management of personal brush
   asset libraries.
-- :ref:`Manual Storage <brush-management-manual>`: Create and update brush assets by opening blend files within asset
-  libraries, and managing brush asset data-blocks in there. Useful for careful curation of asset libraries, especially
-  to prepare them for sharing with others.
+- Using :ref:`manual storage <brush-management-manual>`: Create and update brush assets by opening
+  blend files within asset libraries, and managing brush asset data-blocks in there. Useful for
+  careful curation of asset libraries, especially to prepare them for sharing with others.
 
 .. _brush-management-utility-operators:
 
@@ -22,11 +23,11 @@ updating the brushes in asset libraries for you. Assets managed this way will be
 :ref:`asset system files <asset-system-files>` using a `.asset.blend` file extension.
 
 .. note::
-   Note that only brush assets created via :ref:`Duplicate Asset... <bpy.ops.brush.asset_save_as>`
+   Note that only brush assets created via :ref:`Duplicate Asset <bpy.ops.brush.asset_save_as>`
    can be edited further using these asset operators. For others, these operations will be grayed
    out, and :ref:`manual management <brush-management-manual>` is necessary.
 
-   Brushes from the **Essentials** asset library cannot be edited.
+   Brushes from the *Essentials* asset library cannot be edited.
 
 .. reference::
 
@@ -35,11 +36,11 @@ updating the brushes in asset libraries for you. Assets managed this way will be
                :menuselection:`Properties --> Tool --> Brush Asset`
    :Menu:      :menuselection:`Asset Shelf --> Context Menu`
 
-.. figure:: /images/sculpt_paint_brush_brush-management_asset-operators.png
+.. figure:: /images/sculpt-paint_brush_brush-management_asset-operators.png
    :align: right
    :width: 300
 
-   Brush Asset panel in the tool settings showing asset operators.
+   Brush Asset panel in the Sidebar showing asset operators.
 
 .. _bpy.ops.brush.asset_save_as:
 
@@ -82,6 +83,24 @@ Revert to Asset
 Manual Storage
 ==============
 
-It is also possible to manually manage brushes in blend-files. By marking brushes as assets and saving the file in an
-Asset Library, they become available from any Blender session. This gives full control over managing storage, and is
-particularly useful for curating asset libraries that can be shared with others.
+.. seealso::
+   :ref:`asset-life-cycle`
+      Complete description of the manual asset create, edit, share and use workflow.
+
+It is also possible to manually manage brushes in blend-files like any other asset data-block. By
+marking brushes as assets and saving the file in an asset library, they become available from any
+Blender session. This gives full control over how assets are stored, and is particularly useful for
+curating asset libraries that can be shared with others.
+
+.. figure:: /images/sculpt-paint_brush_brush-management_mark-as-asset.png
+   :align: right
+   :width: 350
+
+   The *Mark as Asset* operator used on a brush in the Outliner.
+
+Brushes can be imported as normal data-blocks from other files (including from `.asset.blend` files
+from an asset library) through :ref:`appending <bpy.ops.wm.append>`. In the
+:ref:`Blender File <outliner-blender-file-mode>` mode of the Outliner, the brush will be listed
+under *Brushes*. Right-click the brush and select *Mark as Asset*. By saving the file inside of
+an asset library directory, the asset becomes available from all Blender sessions. If necessary,
+configure an asset library directory in the Preferences.