I still think there is a lot of value in both the 'this is how this API is typically used' and the 'see other examples'. Even if the authors of the code provide

I still think there is a lot of value in both the 'this is how this API is typically used' and the 'see other examples'. Even if the authors of the code provide some sort of documentation and examples for how things are used, there is lot of data about how consumers actually use their API's. I think it would be really cool to be able to see how others (publicly or privately) use certain APIs. I think it would help with faster adoption and "crowdsourcing" documentation. I can't tell you how many times I have had to Google/Stack Overflow Spring (and other library) specific things because I just wasn't sure if it could be used in a certain context based on the documentation present in an IDE or the project's documentation.