I would hazard a guess that most people don't load up the docs' index page, but instead land on pages directly by googling - and so don't see the "Deprecated Widgets" section. For example if I google "gtk list widget" a GtkList tutorial page is the fourth result. [1] Although admittedly, that doesn't explain why someone wouldn't click on one of the perfectly fine top three results.