Fix #1047: Improve documentation for parameter position.

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.

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