It's not about documentation vs. deprecation, it's about breaking peoples' already working configs. We do actually have some users :-). There are also no docs updates in this patch :-(. Anyway, shouldn't be too hard to just pull the old value out and use it if it's there. There is an example of how to do a deprecation warning in libqtile/widget/clock.py.