diff --git a/images/en/Krita_Artistic_Color_Selector_Docker.png b/images/en/Krita_Artistic_Color_Selector_Docker.png
index 0000000000000000000000000000000000000000..0000000000000000000000000000000000000000
GIT binary patch
literal 0
Hc$@<O00001

literal 0
Hc$@<O00001

diff --git a/images/en/Krita_Artistic_Color_Selector_Docker_2.png b/images/en/Krita_Artistic_Color_Selector_Docker_2.png
index 0000000000000000000000000000000000000000..0000000000000000000000000000000000000000
GIT binary patch
literal 0
Hc$@<O00001

literal 0
Hc$@<O00001

diff --git a/images/en/Krita_Artistic_Color_Selector_Docker_3.png b/images/en/Krita_Artistic_Color_Selector_Docker_3.png
index 0000000000000000000000000000000000000000..0000000000000000000000000000000000000000
GIT binary patch
literal 0
Hc$@<O00001

literal 0
Hc$@<O00001

diff --git a/images/en/Krita_Gamut_Mask_Docker.png b/images/en/Krita_Gamut_Mask_Docker.png
index 0000000000000000000000000000000000000000..0000000000000000000000000000000000000000
GIT binary patch
literal 0
Hc$@<O00001

literal 0
Hc$@<O00001

diff --git a/images/en/Krita_Gamut_Mask_Docker_2.png b/images/en/Krita_Gamut_Mask_Docker_2.png
index 0000000000000000000000000000000000000000..0000000000000000000000000000000000000000
GIT binary patch
literal 0
Hc$@<O00001

literal 0
Hc$@<O00001

diff --git a/reference_manual/dockers/advanced_color_selector.rst b/reference_manual/dockers/advanced_color_selector.rst
--- a/reference_manual/dockers/advanced_color_selector.rst
+++ b/reference_manual/dockers/advanced_color_selector.rst
@@ -149,6 +149,21 @@
 
 The common patches are generated from the image, and are the most common colour in the image. The hotkey for them on canvas is :kbd:`U`.
 
+Gamut masking
+-------------
+
+.. versionadded:: 4.2
+
+.. note::
+
+   Gamut masking is available only when the selector shape is set to wheel.
+
+You can select and manage your gamut masks in the :ref:`gamut_mask_docker`.
+
+In the gamut masking toolbar at the top of the selector you can toggle the selected mask off and on (left button). You can also rotate the mask with the rotation slider (right).
+
+
+
 External Info
 -------------
 
diff --git a/reference_manual/dockers/artistic_color_selector.rst b/reference_manual/dockers/artistic_color_selector.rst
--- a/reference_manual/dockers/artistic_color_selector.rst
+++ b/reference_manual/dockers/artistic_color_selector.rst
@@ -12,62 +12,84 @@
 .. index:: Color, Color Selector, ! Artistic Color Selector
 .. _artistic_color_selector_docker:
 
-============================
-Artist Color Selector Docker
-============================
+==============================
+Artistic Color Selector Docker
+==============================
 
-.. image:: /images/en/Krita_Artistic_Color_Selector_Docker.png
-
-A round selector that tries to give you the tools to select colors ramps efficiently.
+A color selector inspired by traditional color wheel and workflows.
 
 Usage
 -----
 
-Select hue and saturation on the wheel (5) and value on the value scale (4). |mouseleft| changes foreground color (6). |mouseright| changes background color (7).
+.. figure:: /images/en/Krita_Artistic_Color_Selector_Docker.png
 
-Last selected swatches are outlined with red.
+  Artistic color selector with a gamut mask
 
-The blip shows the position of current foreground color on the wheel (black and white circle) and on the value scale (black and white line).
+Select hue and saturation on the wheel (5) and value on the value scale (4). |mouseleft| changes foreground color (6). |mouseright| changes background color (7).
 
-This selector does not update on change of foreground color.
+The blip shows the position of current foreground color on the wheel (black&white circle) and on the value scale (black&white line). Last selected swatches are outlined.
 
-The selector
-------------
+Parameters of the wheel can be set in :ref:`artistic_color_selector_docker_wheel_preferences` menu (2). Selector settings are found under :ref:`artistic_color_selector_docker_selector_settings` menu (3).
 
-.. image:: /images/en/Krita_Artistic_Color_Selector_Docker_2.png
+Gamut Masking
+~~~~~~~~~~~~~
 
+You can select and manage your gamut masks in the :ref:`gamut_mask_docker`.
 
-1 - gamut masking toolbar
-    The toolbar consists of a toggle button to turn the mask off and on (left) and current mask title (right).
+In the gamut masking toolbar (1) you can toggle the selected mask off and on (left button). You can also rotate the mask with the rotation slider (right).
 
-    Masks are selected and managed in the “Gamut Masks” docker. (Link)
-2 - color wheel preferences menu (link to section)
-3 - selector settings menu (link to section)
-4 - value scale
-    * Optional comparative gray scale with lightness percentage on the left
-    * The black and white line (the blip) shows current foreground color’s value
-    * For HSY model, the value scale can be adjusted by user-defined gamma
 
-5 - the wheel
-    * The wheel is divided into color swatches by hue sectors and saturation rings.
-    * The black and white circle (the blip) shows current foreground color’s hue and saturation.
-6 - current foreground color
-7 - current background color
+.. _artistic_color_selector_docker_wheel_preferences:
 
-Wheel preferences
------------------
+Color wheel preferences
+-----------------------
 
-.. image:: /images/en/Krita_Artistic_Color_Selector_Docker_3.png
+.. _artistic_color_selector_docker_fig_wheel_preferences:
+.. figure:: /images/en/Krita_Artistic_Color_Selector_Docker_3.png
 
+   Color wheel preferences
 
-Sliders 1, 2, and 3 
+Sliders 1, 2, and 3
     adjust the number of steps of the value scale, number of hue sectors and saturation rings on the wheel, respectively.
 
 Continuous Mode
     The value scale and hue sectors can also be set to continuous mode (with the infinity icon on the right of the slider). If toggled on, the respective area shows a continuous gradient instead of the discreet swatches.
 
 Invert saturation (4)
-    changes the order of saturation rings within the the hue sectors. By default, the wheel has gray in the center and most saturated colors on the perimeter. “Inverted saturation” puts gray on the perimeter and most saturated colors in the center.
+    changes the order of saturation rings within the the hue sectors. By default, the wheel has gray in the center and most saturated colors on the perimeter. :guilabel:`Invert saturation` puts gray on the perimeter and most saturated colors in the center.
 
 Reset to default (5)
-    loads default values for the sliders 1,2 and 3. These default values are configured in selector settings. 
+    loads default values for the sliders 1,2 and 3. These default values are configured in selector settings.
+
+
+.. _artistic_color_selector_docker_selector_settings:
+
+Selector settings
+-----------------
+
+.. figure:: /images/en/Krita_Artistic_Color_Selector_Docker_2.png
+
+  Selector settings menu
+
+Selector Appearance (1)
+    Show background color indicator
+      toggles the bottom-right triangle with current background color.
+    Show numbered value scale
+      If checked, the value scale includes a comparative gray scale with lightness percentage.
+
+Color Space (2)
+    Set the color model used by the selector. For detailed information on color models, see :ref:`color_models`.
+
+    Luma Coefficients (3)
+      If the selector's color space is HSY, you can set custom Luma coefficients and the amount of gamma correction applied to the value scale (set to 1.0 for linear scale; see :ref:`linear_and_gamma`).
+
+Gamut Masking Behavior (4)
+    The selector can be set either to :guilabel:`Enforce gamut mask`, so that colors outside the mask cannot be selected, or to :guilabel:`Just show the shapes`, where the mask is visible but color selection is not limited.
+
+Default Selector Steps Settings
+    Values the color wheel and value scale will be reset to when the :guilabel:`Reset to default` button in :ref:`artistic_color_selector_docker_wheel_preferences` is pressed.
+
+External Info
+-------------
+- `HSI and HSY for Krita’s advanced colour selector by Wolthera van Hövell tot Westerflier <http://wolthera.info/?p=726>`_
+- `The Color Wheel, Part 7 by James Gurney <https://gurneyjourney.blogspot.com/2010/02/color-wheel-part-7.html>`_
diff --git a/reference_manual/dockers/gamut_mask_docker.rst b/reference_manual/dockers/gamut_mask_docker.rst
--- a/reference_manual/dockers/gamut_mask_docker.rst
+++ b/reference_manual/dockers/gamut_mask_docker.rst
@@ -47,7 +47,7 @@
 
 If you choose to create a new mask, edit, or duplicate selected mask, the mask template documents opens as a new view (1).
 
-There you can modify the mask with standard vector tools, or create any vector shape supported by Krita. 
+There you can modify the mask with standard vector tools, or create any vector shape supported by Krita.
 
 Fill in the fields at (2).
 
@@ -58,15 +58,21 @@
 
 :guilabel:`Preview` the mask in the artistic color selector (4), :guilabel:`save` the mask (5), or :guilabel:`cancel` editing (3).
 
-Please note, that the shapes need to be added to the layer named “maskShapesLayer” (which is selected by default). The shapes need have solid background to show correctly in the editor. A template with no shapes cannot be saved.
+.. warning::
 
-The mask is intended to be composed of basic vector shapes. Although interesting results might arise from using advanced vector drawing techniques, not all features are guaranteed to work properly (e.g. grouping, vector text, etc.).
+  * The shapes need to be added to the layer named “maskShapesLayer” (which is selected by default).
+  * The shapes need have solid background to show correctly in the editor.
+  * A template with no shapes cannot be saved.
+
+.. note::
+
+ The mask is intended to be composed of basic vector shapes. Although interesting results might arise from using advanced vector drawing techniques, not all features are guaranteed to work properly (e.g. grouping, vector text, etc.).
 
 .. image:: /images/en/Krita_Gamut_Mask_Docker_2.png
 
 External Info
 -------------
 
-- `<https://gurneyjourney.blogspot.com/2008/01/color-wheel-masking-part-1.html>`_
-- `<https://gurneyjourney.blogspot.com/2008/02/shapes-of-color-schemes.html>`_
-- `<https://youtu.be/qfE4E5goEIc>`_
+- `Color Wheel Masking, Part 1 by James Gurney <https://gurneyjourney.blogspot.com/2008/01/color-wheel-masking-part-1.html>`_
+- `The Shapes of Color Schemes by James Gurney <https://gurneyjourney.blogspot.com/2008/02/shapes-of-color-schemes.html>`_
+- `Gamut Masking Demonstration by James Gourney (YouTube) <https://youtu.be/qfE4E5goEIc>`_