DOC: start documenting image API more