I agree there is a lot of value to have it do, what it considers, the obvious thing.

It is almost by definition what the average programmer would expect to find, so it's valuable as such.

But the moment you want to do something original, you need to keep high-level high-quality documentation somewhere.