On Mon, Sep 21, 2026 at 11:09 PM Chao Li <li.evan.chao@gmail.com> wrote:
> I tried to build the HTML page, and see that <xref linkend="guc-output-plugin-libraries-builtins”/> is rendered as
“Table19.2”, so it looks like “(Table 19.2 documents ….)”,
Right. (I've attached a sample screenshot for everyone.)
> which looks a little awkward.
Any particular reason?
> How about not using parentheses, and just say something like: See <xref
linkend="guc-output-plugin-libraries-builtins"/>for the effects of removing these plugins from the list.
Mm, it's easier for my brain to figure out *why* we're saying it with
the parenthetical, because it's meant to be an aside. "If you're
motivated to remove these, maybe take a look at what they do first.
Otherwise, don't worry about it and keep reading." It's the sort of
thing a book might use a footnote for, but it's really difficult to
use footnotes well on these pages.
--
Thanks everybody for the reviews! v2 has the backpatchable piece. It
doesn't incorporate Kuroda-san's suggested new section from upthread,
since that's master-only and can be committed separately once we have
the wording we like.
--Jacob
