Some examples of products that tackle this general problem are:
- Codestream: discussions embedded in codebase
- Dendron: better documentation
- Readme: interactive api docs
How do you manage complexity in your code? Are there any tools you wish existed that don't?
Auto-generated documents focus on the file/class/line level details, but they don't tell you the overall architecture, how components work with each other, the lifetime of components.