I think thoughtful, detailed guides on how to browse/use code is better than code documentation. Too often (mostly in interpreted language), I see a method tha

I think thoughtful, detailed guides on how to browse/use code is better than code documentation. Too often (mostly in interpreted language), I see a method that takes a hash as an option and I see that option being passed down to 3, 4 or more different functions. So in order to know what options are available for a given method, you have to browse through all the other methods that takes the same hash as argument. I haven't seen a framework dealing with that through documentation. Some are better than others, but they never cover everything.