Small docs rewrite on deprecation notes for 2.5.1