Originally posted by entropy
View Post
IMO the problem is that the docs keep getting big enough that they can't be maintained with the available people/time, and we have to keep cutting them back to the point where they can be kept current and "clean". Docco on "how each piece of code works" should be in the code, not a separate document -- the purpose of the top level doc needs to be more of an architectural introduction.
At first glance the latest book does seem to have the right level of detail, which is really promising (although I guess some would say that's just cause it ain't finished yet ).
Comment