Document add_image signature and how it works

[TimMonko]

This PR is a trial in figuring out just how convoluted the add_image signature is :/ It's ready now, at least

Originally posted by @TimMonko in napari/napari#9292 (comment)

Or just improve it on the napari/napari side. This PR shows how obtuse it is.