document both fast and slow ways of building images