fix images, add return values paragraph