Update documentation for reading n-d image data

[simonrw]

We need to be clear on the use cases for the different read_ methods for images. For example, read_rows should really be used for 2-d images, whereas read_section is more general, and can be used with n-d arrays.

See #165 for more information.