bump version 3.2.0

add some UPGRADING documentation