Documentation change on coordinates parameter for slices()

This PR attempts to resolve issue #501 and make it clear what coordinates need to be passed into slices() and what is returned back to the user.