AJ-proof legacy polar depreaction warnings

Author: etpinard

src/plots/polar/legacy/area_attributes.js

@@ -12,19 +12,24 @@ var scatterAttrs = require('../../../traces/scatter/attributes');
 var scatterMarkerAttrs = scatterAttrs.marker;
 var extendFlat = require('../../../lib/extend').extendFlat;
 
-var deprecationWarning = 'Area traces are deprecated!';
+var deprecationWarning = [
+    'Area traces are deprecated!',
+    'Please switch to the *barpolar* trace type.'
+].join(' ');
 
 module.exports = {
     r: extendFlat({}, scatterAttrs.r, {
         description: [
             deprecationWarning,
-            scatterAttrs.r.description
+            'Sets the radial coordinates',
+            'for legacy polar chart only.'
         ].join(' ')
     }),
     t: extendFlat({}, scatterAttrs.t, {
         description: [
             deprecationWarning,
-            scatterAttrs.t.description
+            'Sets the angular coordinates',
+            'for legacy polar chart only.'
         ].join(' ')
     }),
     marker: {

src/plots/polar/legacy/axis_attributes.js

@@ -13,7 +13,10 @@ var axesAttrs = require('../../cartesian/layout_attributes');
 var extendFlat = require('../../../lib/extend').extendFlat;
 var overrideAll = require('../../../plot_api/edit_types').overrideAll;
 
-var deprecationWarning = 'Legacy polar charts are deprecated!';
+var deprecationWarning = [
+    'Legacy polar charts are deprecated!',
+    'Please switch to *polar* subplots.'
+].join(' ');
 
 var domainAttr = extendFlat({}, axesAttrs.domain, {
     description: [

src/traces/scatter/attributes.js

@@ -544,18 +544,20 @@ module.exports = {
         valType: 'data_array',
         editType: 'calc',
         description: [
-            'For legacy polar chart only.',
-            'Please switch to *scatterpolar* trace type.',
-            'Sets the radial coordinates.'
+            'r coordinates in scatter traces are deprecated!',
+            'Please switch to the *scatterpolar* trace type.',
+            'Sets the radial coordinates',
+            'for legacy polar chart only.'
         ].join('')
     },
     t: {
         valType: 'data_array',
         editType: 'calc',
         description: [
-            'For legacy polar chart only.',
-            'Please switch to *scatterpolar* trace type.',
-            'Sets the angular coordinates.'
+            't coordinates in scatter traces are deprecated!',
+            'Please switch to the *scatterpolar* trace type.',
+            'Sets the angular coordinates',
+            'for legacy polar chart only.'
         ].join('')
     }
 };