It's certainly good at being descriptive but it's still very focused on the reference style interface. Which is fine of course, but it doesn't really help with

It's certainly good at being descriptive but it's still very focused on the reference style interface. Which is fine of course, but it doesn't really help with the latter case as anything other than a secondary concern. That's great when your primary usage is as a reference but suffers the same problem as JSDoc/etc when it isn't. But it's a better form of what it's doing, for sure.