docs update for the upcoming 2.5.0 release, #396