Wondering how to balance the difference between "go to this other place to read about a plugin" vs inline docs that may not even mention the plugin.

Ideally we should have both. A shorten link that points to the full docs + an inline description that helps people in the 80% cases

Maybe you see this differently than me but my view is this [pr] is 1) super needed 2) experimental stage (product wise). So, my feeling is we can keep things pretty raw for now, including docs.

I have the same feeling. It's something along the lines of "I want it to be there but don't want to make too much noise about it yet".