Updates docs 3.1.0

various doc updates in preparations for new releasse