api: clarifying parameter-argument distinction with image
minor edits for style