manual/sculpt_paint/brush/introduction.rst

@@ -8,9 +8,9 @@ Introduction
 
    Brush cursor.
 
-The brush is the main way of interacting with any painting and sculpting mode.
+Brushes are the main way of interacting with any painting and sculpting mode.
 While click & dragging in the 3D Viewport it will create a :doc:`stroke </sculpt_paint/brush/stroke>`
-and apply an effect depending on various brush settings.
+and apply an effect depending on the used brush and brush/tool settings.
 
 .. tip::
 
@@ -34,13 +34,26 @@ Finally confirm (:kbd:`LMB`, :kbd:`Return`) or cancel (:kbd:`RMB`, :kbd:`Esc`).
 
 You can also invert the brush direction/effect by holding :kbd:`Ctrl`.
 
+Brush Assets
+============
+
+Brushes are used as assets, and stored in :doc:`asset libraries </files/asset_libraries/introduction>`. This makes the
+brushes shared across project files. All available brush assets can be displayed in the Asset Browser, which also
+provides ways to organize them.
+
+Blender comes bundled with a number of brushes in the `Essentials` asset library. These can be customized into all
+kinds of custom brushes by duplicating them (see :doc:`Brush Editing<brush-editing>`).
+
+While it's possible to have brush data-blocks that are local to the file and not marked as assets, such brushes cannot
+be activated for actual painting or sculpting. Use the `Mark as Asset` operator to make them brush assets that can be
+activated.
+
 .. _bpy.types.Brush:
 .. _bpy.ops.brush:
 .. _bpy.types.UnifiedPaintSettings:
 
-*******
 Brush Editing
-*******
+=============
 
 .. reference::