improve documentation around what's new in 2.5