some generalization and adjustments of "custom image" workflow/doc