Когда в опенсорсном проекте наблюдается сильное бурление коммитов, то обычно стоит ожидать, что с документацией будет полнейшая задница. Она будет ужасно отставать, на мажорную версию как минимум.
Например, в ExtJS все вот так вот печально.
Приятные встреченные мной исключения — это Django и Symfony. Но Symfony релизится соборным способом, и полноту доков они гарантируют на момент релиза. В принципе, это ожидаемо. Django вроде как поспевает за разработкой.
Худший из сценариев — это когда берется мануал по той версии библиотеки, которая была наиполнее документированной, а потом пропасть между версиями заполняется чейнджлогом, пробами и ошибками (ибо ничего другого нет, а то, что есть, лучше бы его не было, ибо мешает зело). Хуже него только тогда, когда пробелы надо заполнять логом из системы управления версиями.
