Merge pull request #3082 from thatneat/patch-1

Clarify documentation for "overlaying"
plotly · Oct 5, 2018 · 5cc37e3 · 5cc37e3
2 parents 9f5733d + 11734a3
commit 5cc37e3
Showing 1 changed file with 5 additions and 2 deletions.
diff --git a/src/plots/cartesian/layout_attributes.js b/src/plots/cartesian/layout_attributes.js
@@ -687,8 +687,11 @@ module.exports = {
         editType: 'plot',
         description: [
             'If set a same-letter axis id, this axis is overlaid on top of',
-            'the corresponding same-letter axis.',
-            'If *false*, this axis does not overlay any same-letter axes.'
+            'the corresponding same-letter axis, with traces and axes visible for both',
+            'axes.',
+            'If *false*, this axis does not overlay any same-letter axes.',
+            'In this case, for axes with overlapping domains only the highest-numbered',
+            'axis will be visible.'
         ].join(' ')
     },
     layer: {