update docs for new handling of fallback, update our own images