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 
Is there a specific reason to the style of these notes? It is different from both boto and the cli. It would be nice if botocore followed the CLI ``CHANGELOG`` style or whatever style boto3 plans to use.