I think the docs will be continuously improved. Moving through the github issues can help out and also forking and pushing updates to the docs. I love the new developments; however, developers new to bootstrap or the older ones using 1.4 circa bootstrap might not read the changelogs or version notes and a great many changes are made to the framework. For example, a while back, the tablesorter was removed from 2.0 (still present in 1.4).
I think the majority of developers would love to see the documentation improved on time; I agree with djazzmusic's thoughts on this matter.
