Documentation update

Add migration guide and some informations.
Need more information : 
Class added / class removed /
useful methods added / removed or deprecated