porque somos uma equipe bastante pequena mantendo uma base de código enorme e tendo que implementar novos recursos para clientes pagantes, ao mesmo tempo em que fornecemos suporte e mantemos tudo funcionando para nossa comunidade de código aberto.
Há um limite do que podemos fazer em um dia, e a documentação frequentemente fica para trás.
Compreendo muito bem suas frustrações, mas acho que esse ponto merece ser mencionado também.