The first sentence of a deprecation should indicate what to use instead so that shows up in the summary - having "this will be removed in 3.0" show up in the summary is much less useful.