update documentation
officially add getScale to the interfaces so we can use it in other packages (eg to decide if we want to show the link to the cropping editor