Since sphinx is enabled in the next release Ithink this does not need an extrachngalog entry, but the docstring for the tools could include a short example with a particular plugin. Why the opts need expansion is still a little unclear to me. Is it that some plugins may expect the tools to be found in the PATH and that case would not be covered. To be honest, I am not super familiar with sphinx and these questions could be just my ignorance.

. Why the opts need expansion is still a little unclear to me. Is it that some plugins may expect the tools to be found in the PATH and that case would not be covered.

Sure, something like this?

sphinx_docs(
    ...
    name = ...,
    srcs = ...,
    extra_opts = [
        "-Dsome_binary=$(execpath //:some_binary_target)",
    ],
    tools = [
        "//:some_binary_target",
    ],
)

Mostly lgtm, just need the extra_opts doc updated (I couldn't suggest an edit since it wasn't a modified line)

Thanks, applied requested changes.