changed descriptions of some histogram parameters

Author: yankev

src/traces/histogram/attributes.js

@@ -82,15 +82,21 @@ module.exports = {
         role: 'style',
         description: [
             'Determines whether or not the x axis bin attributes are picked',
-            'by an algorithm.'
-        ].join(' ')
+            'by an algorithm. Note that this should be set to false if you',
+            'want to manually set the number of bins using the attributes in',
+            'xbins'
+          ].join(' ')
     },
     nbinsx: {
         valType: 'integer',
         min: 0,
         dflt: 0,
         role: 'style',
-        description: 'Sets the number of x axis bins.'
+        description: [
+          'Specifies the desired amount of bins. This value will be used',
+          'in an algorithm that will decide the optimal bin size such that the',
+          'histogram best visualizes the distribution of the data'
+        ]
     },
     xbins: makeBinsAttr('x'),
 
@@ -99,16 +105,22 @@ module.exports = {
         dflt: true,
         role: 'style',
         description: [
-            'Determines whether or not the y axis bin attributes are picked',
-            'by an algorithm.'
+          'Determines whether or not the y axis bin attributes are picked',
+          'by an algorithm. Note that this should be set to false if you',
+          'want to manually set the number of bins using the attributes in',
+          'ybins'
         ].join(' ')
     },
     nbinsy: {
         valType: 'integer',
         min: 0,
         dflt: 0,
         role: 'style',
-        description: 'Sets the number of y axis bins.'
+        description: [
+          'Specifies the desired amount of bins. This value will be used',
+          'in an algorithm that will decide the optimal bin size such that the',
+          'histogram best visualizes the distribution of the data'
+        ]
     },
     ybins: makeBinsAttr('y'),