diff --git a/future_changes.md b/future_changes.md
index 93989349caf..661780bb5e4 100644
--- a/future_changes.md
+++ b/future_changes.md
@@ -12,6 +12,7 @@
 - Support arrow() in geom_spoke() [[#986](https://github.com/JetBrains/lets-plot/issues/986)].
 - Support geom_spoke() in geom_livemap() [[#988](https://github.com/JetBrains/lets-plot/issues/988)].
 - arrow on curve sometimes looks weird [[#1041](https://github.com/JetBrains/lets-plot/issues/1041)].
+- Improve documentation for parameter `position` [[#1047](https://github.com/JetBrains/lets-plot/issues/1047)].
 - Livemap: `vjust` implemented incorrectly [[#1051](https://github.com/JetBrains/lets-plot/issues/1051)].
-- `geom_density2d`: the doc missing some 'computed' variables [[#1062](https://github.com/JetBrains/lets-plot/issues/1062)]
+- `geom_density2d`: the doc missing some 'computed' variables [[#1062](https://github.com/JetBrains/lets-plot/issues/1062)].
 - Missing marginal gridlines.
\ No newline at end of file
diff --git a/python-package/lets_plot/plot/core.py b/python-package/lets_plot/plot/core.py
index 8cc89966c1b..9d5e706d4ca 100644
--- a/python-package/lets_plot/plot/core.py
+++ b/python-package/lets_plot/plot/core.py
@@ -95,8 +95,9 @@ def layer(geom=None, stat=None, data=None, mapping=None, position=None, **kwargs
         Aesthetic mappings describe the way that variables in the data are
         mapped to plot "aesthetics".
     position : str or `FeatureSpec`
-        Position adjustment, either as a string ('identity', 'stack', 'dodge', ...),
-        or the result of a call to a position adjustment function.
+        Position adjustment.
+        Either a position adjustment name: ‘dodge’, ‘dodgev’, ‘jitter’, ‘nudge’, ‘jitterdodge’, ‘fill’,
+        ‘stack’ or ‘identity’, or the result of calling a position adjustment function (e.g., position_dodge() etc.).
     kwargs:
         Other arguments passed on to layer. These are often aesthetics settings, used to set an aesthetic to a fixed
         value, like color = "red", fill = "blue", size = 3 or shape = 21. They may also be parameters to the
diff --git a/python-package/lets_plot/plot/geom.py b/python-package/lets_plot/plot/geom.py
index 8c0193967be..01ea04e83a1 100644
--- a/python-package/lets_plot/plot/geom.py
+++ b/python-package/lets_plot/plot/geom.py
@@ -54,8 +54,9 @@ def geom_point(mapping=None, *, data=None, stat=None, position=None, show_legend
         'density' (computes and draws kernel density estimate),
         'sum' (counts the number of points at each location - might help to workaround overplotting).
     position : str or `FeatureSpec`, default='identity'
-        Position adjustment, either as a string ('identity', 'stack', 'dodge', ...),
-        or the result of a call to a position adjustment function.
+        Position adjustment.
+        Either a position adjustment name: ‘dodge’, ‘dodgev’, ‘jitter’, ‘nudge’, ‘jitterdodge’, ‘fill’,
+        ‘stack’ or ‘identity’, or the result of calling a position adjustment function (e.g., position_dodge() etc.).
     show_legend : bool, default=True
         False - do not show legend for this layer.
     sampling : `FeatureSpec`
@@ -225,8 +226,9 @@ def geom_path(mapping=None, *, data=None, stat=None, position=None, show_legend=
         'smooth' (performs smoothing - linear default),
         'density' (computes and draws kernel density estimate).
     position : str or `FeatureSpec`, default='identity'
-        Position adjustment, either as a string ('identity', 'stack', 'dodge', ...),
-        or the result of a call to a position adjustment function.
+        Position adjustment.
+        Either a position adjustment name: ‘dodge’, ‘dodgev’, ‘jitter’, ‘nudge’, ‘jitterdodge’, ‘fill’,
+        ‘stack’ or ‘identity’, or the result of calling a position adjustment function (e.g., position_dodge() etc.).
     show_legend : bool, default=True
         False - do not show legend for this layer.
     sampling : `FeatureSpec`
@@ -402,8 +404,9 @@ def geom_line(mapping=None, *, data=None, stat=None, position=None, show_legend=
         'smooth' (performs smoothing - linear default),
         'density' (computes and draws kernel density estimate).
     position : str or `FeatureSpec`, default='identity'
-        Position adjustment, either as a string ('identity', 'stack', 'dodge', ...),
-        or the result of a call to a position adjustment function.
+        Position adjustment.
+        Either a position adjustment name: ‘dodge’, ‘dodgev’, ‘jitter’, ‘nudge’, ‘jitterdodge’, ‘fill’,
+        ‘stack’ or ‘identity’, or the result of calling a position adjustment function (e.g., position_dodge() etc.).
     show_legend : bool, default=True
         False - do not show legend for this layer.
     sampling : `FeatureSpec`
@@ -517,8 +520,9 @@ def geom_smooth(mapping=None, *, data=None, stat=None, position=None, show_legen
         'smooth' (performs smoothing - linear default),
         'density' (computes and draws kernel density estimate).
     position : str or `FeatureSpec`, default='identity'
-        Position adjustment, either as a string ('identity', 'stack', 'dodge', ...),
-        or the result of a call to a position adjustment function.
+        Position adjustment.
+        Either a position adjustment name: ‘dodge’, ‘dodgev’, ‘jitter’, ‘nudge’, ‘jitterdodge’, ‘fill’,
+        ‘stack’ or ‘identity’, or the result of calling a position adjustment function (e.g., position_dodge() etc.).
     show_legend : bool, default=True
         False - do not show legend for this layer.
     sampling : `FeatureSpec`
@@ -688,8 +692,9 @@ def geom_bar(mapping=None, *, data=None, stat=None, position=None, show_legend=N
         'smooth' (performs smoothing - linear default),
         'density' (computes and draws kernel density estimate).
     position : str or `FeatureSpec`, default='stack'
-        Position adjustment, either as a string ('identity', 'stack', 'dodge', ...),
-        or the result of a call to a position adjustment function.
+        Position adjustment.
+        Either a position adjustment name: ‘dodge’, ‘dodgev’, ‘jitter’, ‘nudge’, ‘jitterdodge’, ‘fill’,
+        ‘stack’ or ‘identity’, or the result of calling a position adjustment function (e.g., position_dodge() etc.).
     show_legend : bool, default=True
         False - do not show legend for this layer.
     sampling : `FeatureSpec`
@@ -840,8 +845,9 @@ def geom_histogram(mapping=None, *, data=None, stat=None, position=None, show_le
         'smooth' (performs smoothing - linear default),
         'density' (computes and draws kernel density estimate).
     position : str or `FeatureSpec`, default='stack'
-        Position adjustment, either as a string ('identity', 'stack', 'dodge', ...),
-        or the result of a call to a position adjustment function.
+        Position adjustment.
+        Either a position adjustment name: ‘dodge’, ‘dodgev’, ‘jitter’, ‘nudge’, ‘jitterdodge’, ‘fill’,
+        ‘stack’ or ‘identity’, or the result of calling a position adjustment function (e.g., position_dodge() etc.).
     show_legend : bool, default=True
         False - do not show legend for this layer.
     sampling : `FeatureSpec`
@@ -1142,8 +1148,9 @@ def geom_bin2d(mapping=None, *, data=None, stat=None, position=None, show_legend
     stat : str, default='bin2d'
         The statistical transformation to use on the data for this layer, as a string.
     position : str or `FeatureSpec`, default='identity'
-        Position adjustment, either as a string ('identity', 'stack', 'dodge', ...),
-        or the result of a call to a position adjustment function.
+        Position adjustment.
+        Either a position adjustment name: ‘dodge’, ‘dodgev’, ‘jitter’, ‘nudge’, ‘jitterdodge’, ‘fill’,
+        ‘stack’ or ‘identity’, or the result of calling a position adjustment function (e.g., position_dodge() etc.).
     show_legend : bool, default=True
         False - do not show legend for this layer.
     sampling : `FeatureSpec`
@@ -1300,8 +1307,9 @@ def geom_tile(mapping=None, *, data=None, stat=None, position=None, show_legend=
     stat : str, default='identity'
         The statistical transformation to use on the data for this layer, as a string.
     position : str or `FeatureSpec`, default='identity'
-        Position adjustment, either as a string ('identity', 'stack', 'dodge', ...),
-        or the result of a call to a position adjustment function.
+        Position adjustment.
+        Either a position adjustment name: ‘dodge’, ‘dodgev’, ‘jitter’, ‘nudge’, ‘jitterdodge’, ‘fill’,
+        ‘stack’ or ‘identity’, or the result of calling a position adjustment function (e.g., position_dodge() etc.).
     show_legend : bool, default=True
         False - do not show legend for this layer.
     sampling : `FeatureSpec`
@@ -1437,8 +1445,9 @@ def geom_raster(mapping=None, *, data=None, stat=None, position=None, show_legen
     stat : str, default='identity'
         The statistical transformation to use on the data for this layer, as a string.
     position : str or `FeatureSpec`, default='identity'
-        Position adjustment, either as a string ('identity', 'stack', 'dodge', ...),
-        or the result of a call to a position adjustment function.
+        Position adjustment.
+        Either a position adjustment name: ‘dodge’, ‘dodgev’, ‘jitter’, ‘nudge’, ‘jitterdodge’, ‘fill’,
+        ‘stack’ or ‘identity’, or the result of calling a position adjustment function (e.g., position_dodge() etc.).
     show_legend : bool, default=True
         False - do not show legend for this layer.
     sampling : `FeatureSpec`
@@ -1526,8 +1535,9 @@ def geom_errorbar(mapping=None, *, data=None, stat=None, position=None, show_leg
         'smooth' (performs smoothing - linear default),
         'density' (computes and draws kernel density estimate).
     position : str or `FeatureSpec`, default='identity'
-        Position adjustment, either as a string ('identity', 'stack', 'dodge', ...),
-        or the result of a call to a position adjustment function.
+        Position adjustment.
+        Either a position adjustment name: ‘dodge’, ‘dodgev’, ‘jitter’, ‘nudge’, ‘jitterdodge’, ‘fill’,
+        ‘stack’ or ‘identity’, or the result of calling a position adjustment function (e.g., position_dodge() etc.).
     show_legend : bool, default=True
         False - do not show legend for this layer.
     sampling : `FeatureSpec`
@@ -1658,8 +1668,9 @@ def geom_crossbar(mapping=None, *, data=None, stat=None, position=None, show_leg
         'smooth' (performs smoothing - linear default),
         'density' (computes and draws kernel density estimate).
     position : str or `FeatureSpec`, default='dodge'
-        Position adjustment, either as a string ('identity', 'stack', 'dodge', ...),
-        or the result of a call to a position adjustment function.
+        Position adjustment.
+        Either a position adjustment name: ‘dodge’, ‘dodgev’, ‘jitter’, ‘nudge’, ‘jitterdodge’, ‘fill’,
+        ‘stack’ or ‘identity’, or the result of calling a position adjustment function (e.g., position_dodge() etc.).
     show_legend : bool, default=True
         False - do not show legend for this layer.
     sampling : `FeatureSpec`
@@ -1788,8 +1799,9 @@ def geom_pointrange(mapping=None, *, data=None, stat=None, position=None, show_l
         'smooth' (performs smoothing - linear default),
         'density' (computes and draws kernel density estimate).
     position : str or `FeatureSpec`, default='identity'
-        Position adjustment, either as a string ('identity', 'stack', 'dodge', ...),
-        or the result of a call to a position adjustment function.
+        Position adjustment.
+        Either a position adjustment name: ‘dodge’, ‘dodgev’, ‘jitter’, ‘nudge’, ‘jitterdodge’, ‘fill’,
+        ‘stack’ or ‘identity’, or the result of calling a position adjustment function (e.g., position_dodge() etc.).
     show_legend : bool, default=True
         False - do not show legend for this layer.
     sampling : `FeatureSpec`
@@ -1913,8 +1925,9 @@ def geom_linerange(mapping=None, *, data=None, stat=None, position=None, show_le
         'smooth' (performs smoothing - linear default),
         'density' (computes and draws kernel density estimate).
     position : str or `FeatureSpec`, default='identity'
-        Position adjustment, either as a string ('identity', 'stack', 'dodge', ...),
-        or the result of a call to a position adjustment function.
+        Position adjustment.
+        Either a position adjustment name: ‘dodge’, ‘dodgev’, ‘jitter’, ‘nudge’, ‘jitterdodge’, ‘fill’,
+        ‘stack’ or ‘identity’, or the result of calling a position adjustment function (e.g., position_dodge() etc.).
     show_legend : bool, default=True
         False - do not show legend for this layer.
     sampling : `FeatureSpec`
@@ -2024,8 +2037,9 @@ def geom_contour(mapping=None, *, data=None, stat=None, position=None, show_lege
     stat : str, default='contour'
         The statistical transformation to use on the data for this layer, as a string.
     position : str or `FeatureSpec`, default='identity'
-        Position adjustment, either as a string ('identity', 'stack', 'dodge', ...),
-        or the result of a call to a position adjustment function.
+        Position adjustment.
+        Either a position adjustment name: ‘dodge’, ‘dodgev’, ‘jitter’, ‘nudge’, ‘jitterdodge’, ‘fill’,
+        ‘stack’ or ‘identity’, or the result of calling a position adjustment function (e.g., position_dodge() etc.).
     show_legend : bool, default=True
         False - do not show legend for this layer.
     sampling : `FeatureSpec`
@@ -2162,8 +2176,9 @@ def geom_contourf(mapping=None, *, data=None, stat=None, position=None, show_leg
     stat : str, default='contourf'
         The statistical transformation to use on the data for this layer, as a string.
     position : str or `FeatureSpec`, default='identity'
-        Position adjustment, either as a string ('identity', 'stack', 'dodge', ...),
-        or the result of a call to a position adjustment function.
+        Position adjustment.
+        Either a position adjustment name: ‘dodge’, ‘dodgev’, ‘jitter’, ‘nudge’, ‘jitterdodge’, ‘fill’,
+        ‘stack’ or ‘identity’, or the result of calling a position adjustment function (e.g., position_dodge() etc.).
     show_legend : bool, default=True
         False - do not show legend for this layer.
     sampling : `FeatureSpec`
@@ -2301,8 +2316,9 @@ def geom_polygon(mapping=None, *, data=None, stat=None, position=None, show_lege
     stat : str, default='identity'
         The statistical transformation to use on the data for this layer, as a string.
     position : str or `FeatureSpec`, default='identity'
-        Position adjustment, either as a string ('identity', 'stack', 'dodge', ...),
-        or the result of a call to a position adjustment function.
+        Position adjustment.
+        Either a position adjustment name: ‘dodge’, ‘dodgev’, ‘jitter’, ‘nudge’, ‘jitterdodge’, ‘fill’,
+        ‘stack’ or ‘identity’, or the result of calling a position adjustment function (e.g., position_dodge() etc.).
     show_legend : bool, default=True
         False - do not show legend for this layer.
     sampling : `FeatureSpec`
@@ -2482,8 +2498,9 @@ def geom_map(mapping=None, *, data=None, stat=None, position=None, show_legend=N
         'smooth' (performs smoothing - linear default),
         'density' (computes and draws kernel density estimate).
     position : str or `FeatureSpec`, default='identity'
-        Position adjustment, either as a string ('identity', 'stack', 'dodge', ...),
-        or the result of a call to a position adjustment function.
+        Position adjustment.
+        Either a position adjustment name: ‘dodge’, ‘dodgev’, ‘jitter’, ‘nudge’, ‘jitterdodge’, ‘fill’,
+        ‘stack’ or ‘identity’, or the result of calling a position adjustment function (e.g., position_dodge() etc.).
     show_legend : bool, default=True
         False - do not show legend for this layer.
     sampling : `FeatureSpec`
@@ -2644,8 +2661,9 @@ def geom_abline(mapping=None, *, data=None, stat=None, position=None, show_legen
     stat : str, default='identity'
         The statistical transformation to use on the data for this layer, as a string.
     position : str or `FeatureSpec`, default='identity'
-        Position adjustment, either as a string ('identity', 'stack', 'dodge', ...),
-        or the result of a call to a position adjustment function.
+        Position adjustment.
+        Either a position adjustment name: ‘dodge’, ‘dodgev’, ‘jitter’, ‘nudge’, ‘jitterdodge’, ‘fill’,
+        ‘stack’ or ‘identity’, or the result of calling a position adjustment function (e.g., position_dodge() etc.).
     show_legend : bool, default=True
         False - do not show legend for this layer.
     sampling : `FeatureSpec`
@@ -2751,8 +2769,9 @@ def geom_hline(mapping=None, *, data=None, stat=None, position=None, show_legend
     stat : str, default='identity'
         The statistical transformation to use on the data for this layer, as a string.
     position : str or `FeatureSpec`, default='identity'
-        Position adjustment, either as a string ('identity', 'stack', 'dodge', ...),
-        or the result of a call to a position adjustment function.
+        Position adjustment.
+        Either a position adjustment name: ‘dodge’, ‘dodgev’, ‘jitter’, ‘nudge’, ‘jitterdodge’, ‘fill’,
+        ‘stack’ or ‘identity’, or the result of calling a position adjustment function (e.g., position_dodge() etc.).
     show_legend : bool, default=True
         False - do not show legend for this layer.
     sampling : `FeatureSpec`
@@ -2865,8 +2884,9 @@ def geom_vline(mapping=None, *, data=None, stat=None, position=None, show_legend
     stat : str, default='identity'
         The statistical transformation to use on the data for this layer, as a string.
     position : str or `FeatureSpec`, default='identity'
-        Position adjustment, either as a string ('identity', 'stack', 'dodge', ...),
-        or the result of a call to a position adjustment function.
+        Position adjustment.
+        Either a position adjustment name: ‘dodge’, ‘dodgev’, ‘jitter’, ‘nudge’, ‘jitterdodge’, ‘fill’,
+        ‘stack’ or ‘identity’, or the result of calling a position adjustment function (e.g., position_dodge() etc.).
     show_legend : bool, default=True
         False - do not show legend for this layer.
     sampling : `FeatureSpec`
@@ -2986,8 +3006,9 @@ def geom_boxplot(mapping=None, *, data=None, stat=None, position=None, show_lege
     stat : str, default='boxplot'
         The statistical transformation to use on the data for this layer, as a string.
     position : str or `FeatureSpec`, default='dodge'
-        Position adjustment, either as a string ('identity', 'stack', 'dodge', ...),
-        or the result of a call to a position adjustment function.
+        Position adjustment.
+        Either a position adjustment name: ‘dodge’, ‘dodgev’, ‘jitter’, ‘nudge’, ‘jitterdodge’, ‘fill’,
+        ‘stack’ or ‘identity’, or the result of calling a position adjustment function (e.g., position_dodge() etc.).
     show_legend : bool, default=True
         False - do not show legend for this layer.
     tooltips : `layer_tooltips`
@@ -3194,8 +3215,9 @@ def geom_violin(mapping=None, *, data=None, stat=None, position=None, show_legen
     stat : str, default='ydensity'
         The statistical transformation to use on the data for this layer, as a string.
     position : str or `FeatureSpec`, default='dodge'
-        Position adjustment, either as a string ('identity', 'stack', 'dodge', ...),
-        or the result of a call to a position adjustment function.
+        Position adjustment.
+        Either a position adjustment name: ‘dodge’, ‘dodgev’, ‘jitter’, ‘nudge’, ‘jitterdodge’, ‘fill’,
+        ‘stack’ or ‘identity’, or the result of calling a position adjustment function (e.g., position_dodge() etc.).
     show_legend : bool, default=True
         False - do not show legend for this layer.
     sampling : `FeatureSpec`
@@ -3579,8 +3601,9 @@ def geom_area_ridges(mapping=None, *, data=None, stat=None, position=None, show_
         Supported transformations: 'identity' (leaves the data unchanged),
         'densityridges' (computes and draws kernel density estimate for each ridge).
     position : str or `FeatureSpec`, default='identity'
-        Position adjustment, either as a string ('identity', 'stack', 'dodge', ...),
-        or the result of a call to a position adjustment function.
+        Position adjustment.
+        Either a position adjustment name: ‘dodge’, ‘dodgev’, ‘jitter’, ‘nudge’, ‘jitterdodge’, ‘fill’,
+        ‘stack’ or ‘identity’, or the result of calling a position adjustment function (e.g., position_dodge() etc.).
     show_legend : bool, default=True
         False - do not show legend for this layer.
     sampling : `FeatureSpec`
@@ -3751,8 +3774,9 @@ def geom_ribbon(mapping=None, *, data=None, stat=None, position=None, show_legen
     stat : str, default='identity'
         The statistical transformation to use on the data for this layer, as a string.
     position : str or `FeatureSpec`, default='identity'
-        Position adjustment, either as a string ('identity', 'stack', 'dodge', ...),
-        or the result of a call to a position adjustment function.
+        Position adjustment.
+        Either a position adjustment name: ‘dodge’, ‘dodgev’, ‘jitter’, ‘nudge’, ‘jitterdodge’, ‘fill’,
+        ‘stack’ or ‘identity’, or the result of calling a position adjustment function (e.g., position_dodge() etc.).
     show_legend : bool, default=True
         False - do not show legend for this layer.
     sampling : `FeatureSpec`
@@ -3867,8 +3891,9 @@ def geom_area(mapping=None, *, data=None, stat=None, position=None, show_legend=
         'smooth' (performs smoothing - linear default),
         'density' (computes and draws kernel density estimate).
     position : str or `FeatureSpec`, default='gstack'
-        Position adjustment, either as a string ('identity', 'stack', 'dodge', ...),
-        or the result of a call to a position adjustment function.
+        Position adjustment.
+        Either a position adjustment name: ‘dodge’, ‘dodgev’, ‘jitter’, ‘nudge’, ‘jitterdodge’, ‘fill’,
+        ‘stack’ or ‘identity’, or the result of calling a position adjustment function (e.g., position_dodge() etc.).
     show_legend : bool, default=True
         False - do not show legend for this layer.
     sampling : `FeatureSpec`
@@ -3996,8 +4021,9 @@ def geom_density(mapping=None, *, data=None, stat=None, position=None, show_lege
         'smooth' (performs smoothing - linear default),
         'density' (computes and draws kernel density estimate).
     position : str or `FeatureSpec`, default='identity'
-        Position adjustment, either as a string ('identity', 'stack', 'dodge', ...),
-        or the result of a call to a position adjustment function.
+        Position adjustment.
+        Either a position adjustment name: ‘dodge’, ‘dodgev’, ‘jitter’, ‘nudge’, ‘jitterdodge’, ‘fill’,
+        ‘stack’ or ‘identity’, or the result of calling a position adjustment function (e.g., position_dodge() etc.).
     show_legend : bool, default=True
         False - do not show legend for this layer.
     sampling : `FeatureSpec`
@@ -4196,8 +4222,9 @@ def geom_density2d(mapping=None, *, data=None, stat=None, position=None, show_le
     stat : str, default='density2d'
         The statistical transformation to use on the data for this layer, as a string.
     position : str or `FeatureSpec`, default='identity'
-        Position adjustment, either as a string ('identity', 'stack', 'dodge', ...),
-        or the result of a call to a position adjustment function.
+        Position adjustment.
+        Either a position adjustment name: ‘dodge’, ‘dodgev’, ‘jitter’, ‘nudge’, ‘jitterdodge’, ‘fill’,
+        ‘stack’ or ‘identity’, or the result of calling a position adjustment function (e.g., position_dodge() etc.).
     show_legend : bool, default=True
         False - do not show legend for this layer.
     sampling : `FeatureSpec`
@@ -4409,8 +4436,9 @@ def geom_density2df(mapping=None, *, data=None, stat=None, position=None, show_l
     stat : str, default='density2df'
         The statistical transformation to use on the data for this layer, as a string.
     position : str or `FeatureSpec`, default='identity'
-        Position adjustment, either as a string ('identity', 'stack', 'dodge', ...),
-        or the result of a call to a position adjustment function.
+        Position adjustment.
+        Either a position adjustment name: ‘dodge’, ‘dodgev’, ‘jitter’, ‘nudge’, ‘jitterdodge’, ‘fill’,
+        ‘stack’ or ‘identity’, or the result of calling a position adjustment function (e.g., position_dodge() etc.).
     show_legend : bool, default=True
         False - do not show legend for this layer.
     sampling : `FeatureSpec`
@@ -4628,8 +4656,9 @@ def geom_jitter(mapping=None, *, data=None, stat=None, position=None, show_legen
         'smooth' (performs smoothing - linear default),
         'density' (computes and draws kernel density estimate).
     position : str or `FeatureSpec`, default='jitter'
-        Position adjustment, either as a string ('identity', 'stack', 'dodge', ...),
-        or the result of a call to a position adjustment function.
+        Position adjustment.
+        Either a position adjustment name: ‘dodge’, ‘dodgev’, ‘jitter’, ‘nudge’, ‘jitterdodge’, ‘fill’,
+        ‘stack’ or ‘identity’, or the result of calling a position adjustment function (e.g., position_dodge() etc.).
     show_legend : bool, default=True
         False - do not show legend for this layer.
     sampling : `FeatureSpec`
@@ -4756,8 +4785,9 @@ def geom_qq(mapping=None, *, data=None, stat=None, position=None, show_legend=No
         'smooth' (performs smoothing - linear default),
         'density' (computes and draws kernel density estimate).
     position : str or `FeatureSpec`, default='identity'
-        Position adjustment, either as a string ('identity', 'stack', 'dodge', ...),
-        or the result of a call to a position adjustment function.
+        Position adjustment.
+        Either a position adjustment name: ‘dodge’, ‘dodgev’, ‘jitter’, ‘nudge’, ‘jitterdodge’, ‘fill’,
+        ‘stack’ or ‘identity’, or the result of calling a position adjustment function (e.g., position_dodge() etc.).
     show_legend : bool, default=True
         False - do not show legend for this layer.
     sampling : `FeatureSpec`
@@ -4882,8 +4912,9 @@ def geom_qq2(mapping=None, *, data=None, stat=None, position=None, show_legend=N
         'smooth' (performs smoothing - linear default),
         'density' (computes and draws kernel density estimate).
     position : str or `FeatureSpec`, default='identity'
-        Position adjustment, either as a string ('identity', 'stack', 'dodge', ...),
-        or the result of a call to a position adjustment function.
+        Position adjustment.
+        Either a position adjustment name: ‘dodge’, ‘dodgev’, ‘jitter’, ‘nudge’, ‘jitterdodge’, ‘fill’,
+        ‘stack’ or ‘identity’, or the result of calling a position adjustment function (e.g., position_dodge() etc.).
     show_legend : bool, default=True
         False - do not show legend for this layer.
     sampling : `FeatureSpec`
@@ -4984,8 +5015,9 @@ def geom_qq_line(mapping=None, *, data=None, stat=None, position=None, show_lege
         'smooth' (performs smoothing - linear default),
         'density' (computes and draws kernel density estimate).
     position : str or `FeatureSpec`, default='identity'
-        Position adjustment, either as a string ('identity', 'stack', 'dodge', ...),
-        or the result of a call to a position adjustment function.
+        Position adjustment.
+        Either a position adjustment name: ‘dodge’, ‘dodgev’, ‘jitter’, ‘nudge’, ‘jitterdodge’, ‘fill’,
+        ‘stack’ or ‘identity’, or the result of calling a position adjustment function (e.g., position_dodge() etc.).
     show_legend : bool, default=True
         False - do not show legend for this layer.
     sampling : `FeatureSpec`
@@ -5108,8 +5140,9 @@ def geom_qq2_line(mapping=None, *, data=None, stat=None, position=None, show_leg
         'smooth' (performs smoothing - linear default),
         'density' (computes and draws kernel density estimate).
     position : str or `FeatureSpec`, default='identity'
-        Position adjustment, either as a string ('identity', 'stack', 'dodge', ...),
-        or the result of a call to a position adjustment function.
+        Position adjustment.
+        Either a position adjustment name: ‘dodge’, ‘dodgev’, ‘jitter’, ‘nudge’, ‘jitterdodge’, ‘fill’,
+        ‘stack’ or ‘identity’, or the result of calling a position adjustment function (e.g., position_dodge() etc.).
     show_legend : bool, default=True
         False - do not show legend for this layer.
     sampling : `FeatureSpec`
@@ -5201,8 +5234,9 @@ def geom_freqpoly(mapping=None, *, data=None, stat=None, position=None, show_leg
         'smooth' (performs smoothing - linear default),
         'density' (computes and draws kernel density estimate).
     position : str or `FeatureSpec`, default='identity'
-        Position adjustment, either as a string ('identity', 'stack', 'dodge', ...),
-        or the result of a call to a position adjustment function.
+        Position adjustment.
+        Either a position adjustment name: ‘dodge’, ‘dodgev’, ‘jitter’, ‘nudge’, ‘jitterdodge’, ‘fill’,
+        ‘stack’ or ‘identity’, or the result of calling a position adjustment function (e.g., position_dodge() etc.).
     show_legend : bool, default=True
         False - do not show legend for this layer.
     sampling : `FeatureSpec`
@@ -5314,8 +5348,9 @@ def geom_step(mapping=None, *, data=None, stat=None, position=None, show_legend=
         'smooth' (performs smoothing - linear default),
         'density' (computes and draws kernel density estimate).
     position : str or `FeatureSpec`, default='identity'
-        Position adjustment, either as a string ('identity', 'stack', 'dodge', ...),
-        or the result of a call to a position adjustment function.
+        Position adjustment.
+        Either a position adjustment name: ‘dodge’, ‘dodgev’, ‘jitter’, ‘nudge’, ‘jitterdodge’, ‘fill’,
+        ‘stack’ or ‘identity’, or the result of calling a position adjustment function (e.g., position_dodge() etc.).
     show_legend : bool, default=True
         False - do not show legend for this layer.
     sampling : `FeatureSpec`
@@ -5420,8 +5455,9 @@ def geom_rect(mapping=None, *, data=None, stat=None, position=None, show_legend=
     stat : str, default='identity'
         The statistical transformation to use on the data for this layer, as a string.
     position : str or `FeatureSpec`, default='identity'
-        Position adjustment, either as a string ('identity', 'stack', 'dodge', ...),
-        or the result of a call to a position adjustment function.
+        Position adjustment.
+        Either a position adjustment name: ‘dodge’, ‘dodgev’, ‘jitter’, ‘nudge’, ‘jitterdodge’, ‘fill’,
+        ‘stack’ or ‘identity’, or the result of calling a position adjustment function (e.g., position_dodge() etc.).
     show_legend : bool, default=True
         False - do not show legend for this layer.
     sampling : `FeatureSpec`
@@ -5588,8 +5624,9 @@ def geom_segment(mapping=None, *, data=None, stat=None, position=None, show_lege
         'smooth' (performs smoothing - linear default),
         'density' (computes and draws kernel density estimate).
     position : str or `FeatureSpec`, default='identity'
-        Position adjustment, either as a string ('identity', 'stack', 'dodge', ...),
-        or the result of a call to a position adjustment function.
+        Position adjustment.
+        Either a position adjustment name: ‘dodge’, ‘dodgev’, ‘jitter’, ‘nudge’, ‘jitterdodge’, ‘fill’,
+        ‘stack’ or ‘identity’, or the result of calling a position adjustment function (e.g., position_dodge() etc.).
     show_legend : bool, default=True
         False - do not show legend for this layer.
     sampling : `FeatureSpec`
@@ -5739,8 +5776,9 @@ def geom_curve(mapping=None, *, data=None, stat=None, position=None, show_legend
         'smooth' (performs smoothing - linear default),
         'density' (computes and draws kernel density estimate).
     position : str or `FeatureSpec`, default='identity'
-        Position adjustment, either as a string ('identity', 'stack', 'dodge', ...),
-        or the result of a call to a position adjustment function.
+        Position adjustment.
+        Either a position adjustment name: ‘dodge’, ‘dodgev’, ‘jitter’, ‘nudge’, ‘jitterdodge’, ‘fill’,
+        ‘stack’ or ‘identity’, or the result of calling a position adjustment function (e.g., position_dodge() etc.).
     show_legend : bool, default=True
         False - do not show legend for this layer.
     sampling : `FeatureSpec`
@@ -5881,8 +5919,9 @@ def geom_spoke(mapping=None, *, data=None, position=None, show_legend=None, samp
         The data to be displayed in this layer. If None, the default, the data
         is inherited from the plot data as specified in the call to ggplot.
     position : str or `FeatureSpec`, default='identity'
-        Position adjustment, either as a string ('identity', 'stack', 'dodge', ...),
-        or the result of a call to a position adjustment function.
+        Position adjustment.
+        Either a position adjustment name: ‘dodge’, ‘dodgev’, ‘jitter’, ‘nudge’, ‘jitterdodge’, ‘fill’,
+        ‘stack’ or ‘identity’, or the result of calling a position adjustment function (e.g., position_dodge() etc.).
     show_legend : bool, default=True
         False - do not show legend for this layer.
     sampling : `FeatureSpec`
@@ -6019,8 +6058,9 @@ def geom_text(mapping=None, *, data=None, stat=None, position=None, show_legend=
         'smooth' (performs smoothing - linear default),
         'density' (computes and draws kernel density estimate).
     position : str or `FeatureSpec`, default='identity'
-        Position adjustment, either as a string ('identity', 'stack', 'dodge', ...),
-        or the result of a call to a position adjustment function.
+        Position adjustment.
+        Either a position adjustment name: ‘dodge’, ‘dodgev’, ‘jitter’, ‘nudge’, ‘jitterdodge’, ‘fill’,
+        ‘stack’ or ‘identity’, or the result of calling a position adjustment function (e.g., position_dodge() etc.).
     show_legend : bool, default=True
         False - do not show legend for this layer.
     sampling : `FeatureSpec`
@@ -6210,8 +6250,9 @@ def geom_label(mapping=None, *, data=None, stat=None, position=None, show_legend
         'smooth' (performs smoothing - linear default),
         'density' (computes and draws kernel density estimate).
     position : str or `FeatureSpec`, default='identity'
-        Position adjustment, either as a string ('identity', 'stack', 'dodge', ...),
-        or the result of a call to a position adjustment function.
+        Position adjustment.
+        Either a position adjustment name: ‘dodge’, ‘dodgev’, ‘jitter’, ‘nudge’, ‘jitterdodge’, ‘fill’,
+        ‘stack’ or ‘identity’, or the result of calling a position adjustment function (e.g., position_dodge() etc.).
     show_legend : bool, default=True
         False - do not show legend for this layer.
     sampling : `FeatureSpec`
@@ -6413,8 +6454,9 @@ def geom_pie(mapping=None, *, data=None, stat=None, position=None, show_legend=N
         Supported transformations: 'identity' (leaves the data unchanged),
         'count2d' (counts number of points with same x,y coordinate).
     position : str or `FeatureSpec`, default='identity'
-        Position adjustment, either as a string ('identity', 'stack', 'dodge', ...),
-        or the result of a call to a position adjustment function.
+        Position adjustment.
+        Either a position adjustment name: ‘dodge’, ‘dodgev’, ‘jitter’, ‘nudge’, ‘jitterdodge’, ‘fill’,
+        ‘stack’ or ‘identity’, or the result of calling a position adjustment function (e.g., position_dodge() etc.).
     show_legend : bool, default=True
         False - do not show legend for this layer.
     sampling : `FeatureSpec`
@@ -6653,8 +6695,9 @@ def geom_lollipop(mapping=None, *, data=None, stat=None, position=None, show_leg
         'smooth' (performs smoothing - linear default),
         'density' (computes and draws kernel density estimate).
     position : str or `FeatureSpec`, default='identity'
-        Position adjustment, either as a string ('identity', 'stack', 'dodge', ...),
-        or the result of a call to a position adjustment function.
+        Position adjustment.
+        Either a position adjustment name: ‘dodge’, ‘dodgev’, ‘jitter’, ‘nudge’, ‘jitterdodge’, ‘fill’,
+        ‘stack’ or ‘identity’, or the result of calling a position adjustment function (e.g., position_dodge() etc.).
     show_legend : bool, default=True
         False - do not show legend for this layer.
     sampling : `FeatureSpec`
@@ -6792,8 +6835,9 @@ def geom_count(mapping=None, *, data=None, stat=None, position=None, show_legend
     stat : str, default='sum'
         The statistical transformation to use on the data for this layer, as a string.
     position : str or `FeatureSpec`, default='identity'
-        Position adjustment, either as a string ('identity', 'stack', 'dodge', ...),
-        or the result of a call to a position adjustment function.
+        Position adjustment.
+        Either a position adjustment name: ‘dodge’, ‘dodgev’, ‘jitter’, ‘nudge’, ‘jitterdodge’, ‘fill’,
+        ‘stack’ or ‘identity’, or the result of calling a position adjustment function (e.g., position_dodge() etc.).
     show_legend : bool, default=True
         False - do not show legend for this layer.
     sampling : `FeatureSpec`
diff --git a/python-package/lets_plot/plot/geom_function_.py b/python-package/lets_plot/plot/geom_function_.py
index b8d2a8c6642..44ff24b9b44 100644
--- a/python-package/lets_plot/plot/geom_function_.py
+++ b/python-package/lets_plot/plot/geom_function_.py
@@ -99,8 +99,9 @@ def geom_function(mapping=None, *, data=None, stat=None, geom=None, position=Non
     geom : str, default='line'
         The geometry to display the function, as a string.
     position : str or `FeatureSpec`, default='identity'
-        Position adjustment, either as a string ('identity', 'stack', 'dodge', ...),
-        or the result of a call to a position adjustment function.
+        Position adjustment.
+        Either a position adjustment name: ‘dodge’, ‘dodgev’, ‘jitter’, ‘nudge’, ‘jitterdodge’, ‘fill’,
+        ‘stack’ or ‘identity’, or the result of calling a position adjustment function (e.g., position_dodge() etc.).
     show_legend : bool, default=True
         False - do not show legend for this layer.
     tooltips : `layer_tooltips`
diff --git a/python-package/lets_plot/plot/stat.py b/python-package/lets_plot/plot/stat.py
index bab811df343..a31859b3e14 100644
--- a/python-package/lets_plot/plot/stat.py
+++ b/python-package/lets_plot/plot/stat.py
@@ -30,8 +30,9 @@ def stat_summary(mapping=None, *, data=None, geom=None,
     geom : str, default='pointrange'
         The geometry to display the summary stat for this layer, as a string.
     position : str or `FeatureSpec`, default='identity'
-        Position adjustment, either as a string ('identity', 'stack', 'dodge', ...),
-        or the result of a call to a position adjustment function.
+        Position adjustment.
+        Either a position adjustment name: ‘dodge’, ‘dodgev’, ‘jitter’, ‘nudge’, ‘jitterdodge’, ‘fill’,
+        ‘stack’ or ‘identity’, or the result of calling a position adjustment function (e.g., position_dodge() etc.).
     show_legend : bool, default=True
         False - do not show legend for this layer.
     sampling : `FeatureSpec`
@@ -170,8 +171,9 @@ def stat_summary_bin(mapping=None, *, data=None, geom=None,
     geom : str, default='pointrange'
         The geometry to display the summary stat for this layer, as a string.
     position : str or `FeatureSpec`, default='identity'
-        Position adjustment, either as a string ('identity', 'stack', 'dodge', ...),
-        or the result of a call to a position adjustment function.
+        Position adjustment.
+        Either a position adjustment name: ‘dodge’, ‘dodgev’, ‘jitter’, ‘nudge’, ‘jitterdodge’, ‘fill’,
+        ‘stack’ or ‘identity’, or the result of calling a position adjustment function (e.g., position_dodge() etc.).
     show_legend : bool, default=True
         False - do not show legend for this layer.
     sampling : `FeatureSpec`
@@ -319,8 +321,9 @@ def stat_ecdf(mapping=None, *, data=None, geom=None,
     geom : str, default='step'
         The geometry to display the ecdf stat for this layer, as a string.
     position : str or `FeatureSpec`, default='identity'
-        Position adjustment, either as a string ('identity', 'stack', 'dodge', ...),
-        or the result of a call to a position adjustment function.
+        Position adjustment.
+        Either a position adjustment name: ‘dodge’, ‘dodgev’, ‘jitter’, ‘nudge’, ‘jitterdodge’, ‘fill’,
+        ‘stack’ or ‘identity’, or the result of calling a position adjustment function (e.g., position_dodge() etc.).
     show_legend : bool, default=True
         False - do not show legend for this layer.
     sampling : `FeatureSpec`
@@ -449,8 +452,9 @@ def stat_sum(mapping=None, *, data=None, geom=None, position=None, show_legend=N
     geom : str, default='point'
         The geometry to display the sum stat for this layer, as a string.
     position : str or `FeatureSpec`, default='identity'
-        Position adjustment, either as a string ('identity', 'stack', 'dodge', ...),
-        or the result of a call to a position adjustment function.
+        Position adjustment.
+        Either a position adjustment name: ‘dodge’, ‘dodgev’, ‘jitter’, ‘nudge’, ‘jitterdodge’, ‘fill’,
+        ‘stack’ or ‘identity’, or the result of calling a position adjustment function (e.g., position_dodge() etc.).
     show_legend : bool, default=True
         False - do not show legend for this layer.
     sampling : `FeatureSpec`