Update docs to add note about back-compat

Also add some very basic upgrading notes for the early adopters.

I also updated the tutorial to use client objects.

cc @danielgtaylor @kyleknap 
Ok sounds good. So if I make bug fixes to botocore, then I do not update the index.rst?