-This module provides local image integration for Media entity (i.e. media type
-provider plugin). The user can map fields from image's Exif data to media bundle
-fields.
-
-### Storing field values
-
-If you want to store field values you will have to map them to actual bundle
-fields. At the momemnt there is no GUI for that, so the only method of doing
-that for now is via CMI.
-
-This whould be an example of that (the field_map section):
-
-```
-langcode: en
-status: true
-dependencies:
- module:
- - media_entity_image
-id: photo
-label: Photo
-description: 'Photo to be used with content.'
-type: image
-type_configuration:
- source_field: field_image
-field_map:
- mime: field_mime
- make: field_make
-```
-
-Project page: http://drupal.org/project/media_entity_image (if you can't find it, it will be created shortly).
+This module provides local image integration for Media entity (i.e.
+media type provider plugin). The user can map fields from image's Exif
+data to media bundle fields.
+
+### Mapping meta-data to drupal fields
+
+If you want to map some of the image meta-data (for example some of the
+EXIF information), follow these steps:
+1- Create a media bundle of type image
+2- Create some normal fields that will be used to store this information
+3- Go back to the bundle edit form, select "Yes" on the "Whether to
+gather exif data" drop down
+4- Map the desired EXIF fields to the fields you created in step 2.
+These will get automatically populated each time the entity is saved and
+the drupal fields on the entity are empty.
+NOTE that this behavior (only mapping the meta-data when the drupal
+field is empty) may change in the future, once this issue is solved:
+https://www.drupal.org/node/2772045
+
+
+Project page: http://drupal.org/project/media_entity_image.