A single cryptic bug due to this practice will more than negate the minor doc readability benefits you get from that. And there will likely be many more than on

A single cryptic bug due to this practice will more than negate the minor doc readability benefits you get from that. And there will likely be many more than one cryptic bug. There are other ways to emphasize it ought to be a dict/mappable. Change its name to be suffixed as "_dict", for example?