Re: [Docutils-develop] Waiting for feedback about issues with the Docutils Doctree [#489]

[Karl O. P. <ko...@ka...>]

On Thu, 20 Jun 2024 13:22:31 -0400
Alan <ala...@gm...> wrote:

> Since I have not seen any developer feedback,
> here is some user feedback.
> 
> - citations without content: I've never seen it
> - footnotes without content or without "label": I've never seen it
> - figures without caption/legend: no "legend" is reasonably common,
> but no caption is extremely rare and is a need met by `image` (I
> believe)

Figures with no caption would still show up in the TOCs list
of figures.  (Or where ever that list shows up.) At least
in docbook.  I think.  Although I don't know how useful that'd
be since no description would be listed.  I suppose it'd have a figure
number, which is not entirely useless.

Further, I've not tried it and didn't go to the DTD or the
specs and actually look.  So take all this with a big
grain of salt.

Anyway, the big difference between figures and images,
in my mind, is that figures tend to appear in some sort
of listing somewhere and images don't.

Regards,

Karl <ko...@ka...>
Free Software:  "You don't pay back, you pay forward."
                 -- Robert A. Heinlein