more documentation (and a method on Image to make docs easier to write)