Cleaned up a bunch of text, added some open issues to discuss

Added section on multiple allocates
Made partial success versus success versus error clearer
Made retry actions clearer