[Development] How to document API only deprecated in future Qt versions
Christian Kandeler
christian.kandeler at qt.io
Fri Sep 15 10:31:34 CEST 2023
On 9/15/23 09:36, Kai Köhne via Development wrote:
> The methods are formally marked as deprecated for Qt 6.10. But the methods are already in the '-obsolete' page for Qt 6.6, which leaves the API in a weird in-between state.
Radical idea: Treat all deprecated functions as if they didn't exist,
i.e. remove the documentation entirely. It seems counter-intuitive that
legacy interfaces should take more documentation effort than current
ones. Also, this way, fewer people will even be tempted to
short-sightedly use them.
Christian
More information about the Development
mailing list