Потому что мы — довольно небольшая команда, поддерживающая огромную кодовую базу, внедряющая новые функции для платных клиентов и одновременно оказывающая поддержку и обеспечивающая стабильную работу для нашего сообщества с открытым исходным кодом.
В сутках есть только так много времени, и документация часто отстаёт.
Я очень хорошо понимаю ваше разочарование, но считаю, что этот момент тоже стоит упомянуть.