[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