diff --git a/src/traces/pie/attributes.js b/src/traces/pie/attributes.js
index ac2cb711006..9d0fafdfec9 100644
--- a/src/traces/pie/attributes.js
+++ b/src/traces/pie/attributes.js
@@ -188,12 +188,13 @@ module.exports = {
         dflt: 'auto',
         editType: 'plot',
         description: [
-            'Determines the orientation of text inside slices.',
-            'With *auto* the texts may automatically be',
-            'rotated to fit with the maximum size inside the slice.',
-            'Using *horizontal* option forces text to be horizontal.',
-            'Using *radial* option forces text to be radial.',
-            'Using *tangential* option forces text to be tangential.'
+            'Controls the orientation of the text inside chart sectors.',
+            'When set to *auto*, text may be oriented in any direction in order',
+            'to be as big as possible in the middle of a sector.',
+            'The *horizontal* option orients text to be parallel with the bottom',
+            'of the chart, and may make text smaller in order to achieve that goal.',
+            'The *radial* option orients text along the radius of the sector.',
+            'The *tangential* option orients text perpendicular to the radius of the sector.'
         ].join(' ')
     },
     insidetextfont: extendFlat({}, textFontAttrs, {