Reorganize the documentation

Will close issue #257 and #273 
Ha, I didn't even see this message here when I made my comment above :). Use which ever wording seems most clear to you. The only "gotcha" is that we want the user to use the "file" field (`image`) not the string field (`imageName`).