It will speed up programming workflow: instead of digging documentation each time or calling dir/help/etc. Python functions, the user can just hover cursor on a layer/brush/etc. they want to access and see how to do it. Note that the first line shows what class some property belongs to, while the second one how to access this property for selected object.