diff -u b/core/modules/options/options.module b/core/modules/options/options.module
--- b/core/modules/options/options.module
+++ b/core/modules/options/options.module
@@ -24,6 +24,10 @@
$output .= '
';
$output .= '- ' . t('Managing and displaying list fields') . '
';
$output .= '- ' . t('The settings and the display of the list field can be configured separately. See the Field UI help for more information on how to manage fields and their display.', array('!field_ui' => \Drupal::url('help.page', array('name' => 'field_ui')))) . '
';
+ $output .= '- ' . t('Choosing list field type') . '
';
+ $output .= '- ' . t('When you add a list field you can choose from three types: float, integer or text. The float type allows users to choose approximate decimal values from a list. The integer type allows users to choose whole numbers, such as years (e.g. 2012) or values (e.g. 1, 2, 5, 305) from a list. The text list field type allow users to choose text values from a list.') . '
';
+ $output .= '- ' . t('Defining option keys and labels') . '
';
+ $output .= '- ' . t('When you define the list options you can define a key and a label. The label will be shown to the users while the key gets stored in the database.') . '
';
$output .= '
';
return $output;
}